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Niniejszy podręcznik zawiera opis zastosowań i opis dyrektyw 
makroasemblerów NM8O0 i MAC, tworzących przesuwalne kody wyni- 


kowe 


dla mikrokomputera ELWRO 800-JUNIOR oraz wykaz instruk= 


cji języka wewnętrznego mikroprocesorów /patrz DODATEK A i B/, 
Wszystkie programy, których opisy znajdują się w podręczniku 
pracują pod kontrolą systemu operacyjnego CP/J, 


Są to programy: 


makroasembler M8O, 

makroasembler MAC, 

program pomocniczy CREF80, 

program łączący L80, 

debuggery symboliczne SID i ZSID 


Przed przystąpieniem do uruchamiania w/w programów należy 
zapoznać się z treścią podręcznika *CP/J, SYSTEM OPERACYJNY 
CP/J dla mikrokomputera ELWRO 800-JUNIOR", 
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1. WSTĘP 


1.1. Symbol programu: M80 

1.2. Nazwa programu: CP/IJ MAKROASEMBLER 
1.3. Nośnik: dysk elastyczny 

3.4. Rodzaj komputera: ELWRO 800-JUNIOR 
1.5. System operacyjny: CP/J 


1.6. Wymagana wielkość pamięci operacyjnej: minimum 29 KB, 
a w tym: ok. 14 KB na program makroasemblera, ok. 5 KB 
na miejsca robocze makroasembiara, ok. 4 KB na bufory 
i ok. 6 KB na systam operacyjny. 


1.7. Język programowania: asembler mikroprocesora INTEL 8080. 
2. PRZEZNACZENIE 


2.1. Dziedzina zastosowania: opracowanie programów dla 
mikroprocesorów typu INTEL 8080 i Zz8O0. 


2.2. Krótki opis rozwiązywanych zndań: translacja programów 
zapisanych w języku makroasemblera INTEL 8080 lub Z80 na 
przesuwalny kod wynikowy. 


3. OGÓLNA CHARAKTERYSTYKA PROGRAMU 
Mak roasembler M8O jest programem produkującym przesuwalny 


kod wynikowy dla mnikrokomputerowych systenów wykorzystują” 
cych mikroprocesory INTEL 8080 lub Z8o. 
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jako pomocniczy program dustarczany razem z makroasemble- 
rem występuje program CREFB0 umożliwiający uzyskanie 
rozszerzonego listingu, zawierającego informacje o odwoła- 


niach wewnątrz asemblcwanego modułu, 


Makroasembler M8O jaka głównego nośnika używa dysków ela- 
stycznych, W czasie asemblacji program źródłowy jest 
pobierany z pliku typu MAC, przesuwalny kod wynikowy jest 
umieszczony w pliku typu REL, a listing jest wyprowadzany 
do pliku typu PRN, 

Dla uzyskania ostatecznej wersji kodu wynikowego programu 
należy użyć programu łącząco-ładującego, który scala 
osobno asemblowane moduły programu tj. programu L80, 


4, DANE WPROWADZANE 


Program translujący M8O czyta program źródłowy umieszczo- 
ny na dyskietce, w pliku o dowolnej nazwie i obowięzkowym 
rozszerzeniu MAC, Czytany plik oprócz instrukcji odpowiada 
jących rozkazom mikroprocesora /INTEL 8080 lub Z80/ za- 
wiera dyrektywy /pseudoinstrukcje/ sterujące pracą pro- 
gramu, podlegającego translacji przez M8o0, 

Szczegóły dotyczące sposobu zapisu programu źródłowego 

i dyrektyw zostały przedstawione w pkt. 7. 


5, DANE WYPROWADZAŃE 


5,1, Format listingu /wydruku/ 


Każda strona listingu makroasemblera M8O posiada 
nagłówek umieszczony w dwóch pierwszych wierszach 
w postaci: 
TITLE tekst M8O z.zz PACE x -y 
SUBYTL tekst 
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gdzie: 


— TITLE tekst 


y <Po 74 


SUBTTL tekst 


stanowi tekst ustalony dyrektywę 
TITLE w programie źródłowym, 

Jeśli dyrektywa ta nie była użyta 

w programie źródłowym, wówczas obszar 
ten pozostaje niezadrukowany, 


jest numerem wersji programu makro- 
asemblera, 

jest głównym numerem strony 1 ulega 
przyrostowi tylko po napotkaniu znaku 
nowej strony w programie źródłowym, 
jest pomocniczym numerem strony, 
który jest powiększany, gdy występi 
dyrektywa PAGE w programie źródłowym 
lub gdy objętość bieżącej strony jest 
wypełniona do końca, 

stanowi tekst ustalony dyrektywą 
SUBTTL w programie źródłowym. Jeśli 
dyrektywa ta nie była użyta w progra- 
mie źródłowym, wówczas obszar ten 
pozostaje niezadrukowany. 


Po nagłówku występuje wiersz pusty a następnie rozpoczy- 


na się tekst listingu. 


Format wiersza listingu jest następujący: 


błąd 
gdzie: 
błąd 
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XxX XXXX w tekst 


- reprezentuje jednoliterowy kod błędu, 
Jeśli błąd nie występuje, pozestaje 
puste, niezadrukowane miejsce, 


- reprezentuje licznik komórek /licznik 
przydziału miejsca w paaięci/ Jest to 
czterocyćrowa liczba szestnastkowa 


- Xx i xXxXxX 


/etandardowo/ iub sześciocyfrowa liczba 
oktalna. Podstawa liczbowa licznika 
kosórak może być wybierana przez parametr 
/0 lub H/ przy wywoływaniu programu 
aakroassmblera /pkt. 6.1/, 


wskazuje tryb asemblacji w następujący 
sposób: 


„ tryb przesuwalnego progranu, 

* tryb przesuwalnych danych, 

! tryb COMMON, 

spacja tryb absolutny, 
zewnętrzny symbol, 


reprezentuje kod stanowięcy wynik asembla- 
cji, xx reprezentuje wartość jednego 
bajtu. Po tej wartości występuje zawsze 
spacja, xxxx reprezentuje wartość dwu- 
bajtowę z tym, że wartość bardziej zne- 
czącego bajtu jest drukowana pierwsza 
/odwrotnie niż wartości tych bajtów są 
umieszczone w pamięci/. Po wartości dwu- 
bajtowej jest drukowany wskaźnik trybu 
asemblacji "n" /opisane już powyżej/, 


reprezentuje wskaźnik, skąd pochodzi 
wiersz programu źródłowego. Jeżeli wynika 
on z dyrektywy INCLUDE, wówczas w tym 
miejscu drukowana jest litera C. Jeżeli 
wiersz ten wynika z rozwinięcia makro- 
instrukcji /MACRO, REPT, IRP, IRPC/, 
wówczas w tym miejscu drukowany jest 

znak +. 


W pozostałych przypadkach miejsce to 
pozostaje puste /spacja/, 
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- tekst 


- reprezentuje pozostałą część wydruku 
wiersza listingu odpowiadającą programo- 
wi źródłowemu., 


5.2. Format tablicy symboli 


Strony listingu zawierające tablice symboli posiadają 


taki sam nagłówek jak listing zasadniczy, z wyjątkiem 
tego, że zamiast numeru strony jest drukowana litera S. 


Na początku tablicy symboli są drukowane w porządku 
alfabetycznym nazwy makroinstrukcji a następnie również 


w porzędku alfabetycznym pozostałe symbole. 
Po każdym symbolu występuje znak tabulacji i wydruk 
wartości tego symbolu. Po wartości symbolu jest drukowa- 


ny jeden z poniższych znaków: 


I 
U 
C 


spacja 
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dla symboli PUBLIC, 
dla symboli bez określonej wartości, 


dla nazwy bloku COMMON /dla określonej nazwy 
bloku COMMON jest arukowana długość tego blo- 
ku w bajtach w postaci liczby heksadecymnalnej 
lub oktalnej/, 


symbol zewnętrzny, 
wartość absolutna, 


wartość względna w trybie przesuwalnego 
programu, 


wartość względna w trybie przesuwalnych 
danych, 


wartość względna COMMON. 


5.3. Listing z opisem odwołań 


Istnieje możliwość uzyskiwania listingu z dodatkowymi 
danymi, zawierającymi informację o odwołaniach wewnętrz 
asemblowanego modułu programu źródłowego. 

Listing taki uzyskuje się przy wykorzystaniu dodatkowe- 
go, obok makroasenblera programu przetwarzającego 

o nazwie CREF80. 

Sposób realizacji tego został opisany w pkt. 6.3. 
Rozszerzony listing z opisem odwołań występuje w zbio- 
rach LST. Zawiera on dodatkowo w stosunku do normalnego 
listingu /przechowywanego w zbiorze typu PRN/: 


a/ numerację dla każdej instrukcji programu źródło- 
wego zapisanę na pierwszej pozycji w wierszu 
listingu, 

b/ tablicę odwołań drukowaną na końcu listingu. 
Tablica ta zawiera symbole uszeregowane w porzą: 
dku alfabetycznym. Dla każdego z symboli podany 
jest zestaw numerów wierszy programu źródłowego, 
w których ten symbol jest używany. Numer wiersza 
w którym jest definiowana wartość tego symbolu 
jest dodatkowo wyróżniany znakiem /y. 


6. OBSŁUGA OPERATORSKA I KOMUNIKATY DLA UŻYTKOWNIKÓW 


6.1. Sposób wywoływania i sterowania pracą makroasenblera 


Po założeniu dyskietki z programem makroasemblera M8O 
/do dysku A: lub B:/ jest on wywoływany z konsoli 
systemowej zleceniem nierezydentnyn: 


M8O 
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W odpowiedzi makroasembler wypisuje na konsoli znak 
gwiazdki, wskazujący, że oczekuje on na podanie linii 
dyrektywy ustalającej sposób pracy makroasenablera. 
Pliki, z którymi pracuje makroasembler M8O0 są wyróżniane 
przez następujące oznaczenia typów /roszczeń/': 


MAC - program źródłowy, 

PRN - plik zawierający listing, 

REL - plik zawierający przesuwalny kod wynikowy, 
COM - plik zawierający kod ładowalny /absolutny/, 
LST - plik zawierający listing z odwołaniami, 


CRF - plik pośredni służący do uzyskania listingu 
z odwołaniami. 


Linia dyrektywy ustalająca sposób pracy makroasemblera 
ma postać: 


wynik, list = źródło parametry 


gdzie: 


źródło oznacza nazwę pliku zawierającego program 
źródłowy /typu MAC/, 

wynik oznacza nazwę pliku na dysku, w którym 
będzie umieszczony kod wynikowy po asenbla- 
cji, stosowany opcjonalnie. Jeżeli nie 
zdefiniowano nazwy tego pliku, wówczas na 
on nazwę taką jak program źródłowy i jest 
typu REL, 

list oznacza nazwę pliku na dysku, w którym będzie 
umieszczony listing, stosowany opcjonalnie, 
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parametry dodatkowe dane sterujące pracą makroasemble- 
ra, zapisywane w postaci pary znaków: 
/litera/. Parametry są stosowane opcjonal- 
nie w dowolnej ilości. Znaczenie poszcze- 
gólnych parametrów podano dalej. 


W przypadku, jeżeli nie sę potrzebne oba pliki zapisane 

z lewej strony równości /tj. wynik i list/ wówczas można 
stosować skrócone zapisy zilustrowane poniższymi przykła- 
dami: 


m WODA - asemblacja zbioru WODA.MAC i utworzenie 
pliku kodu wynikowego WODA.REL bez 
listingu, 

„m WODA - asemblacja zbioru WODA.MAC bez tworzenia 


pliku kodów wynikowych i listingu 
/przydatne dla sprawdzenia błędów/, 


„WATAaWODA - asemnblacja pliku WODA.MAC i utworzenie 
pliku WATA.PRN zawierającego listing, 
bez tworzenia pliku kodów wynikowych. 


W dyrektywie ustalającej sposób pracy makroasemblera, 

w pola oznaczające nazwę plików można też stosować 
wpisywanie nazwy urządzeń w systemie. Przykładowo, dla 
uzyskania bezpośrednio wydruku listingu programu z pliku 
WODA, na drukarce można wprowadzić: 


„LST: = WODA 


Parametry, które można stosować dla sterowania pracą 
makroasemblera są następujące: 


/O0 = tworzenie pliku listingu z adresami zapisanyni 
oktalnie, 

/H - tworzenie pliku listingu z adresami zapisanymi 
heksadecynalnie, 
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/R 


/L 


/C 


/Z 


/P 


/M 


/X 


wygenerowanie pliku kodów wynikowych o nazwie 
takiej, jak program źródłowy, 

wygenerowanie pliku zawierającego listing o nazwie 
takiej, jak program źródłowy, 

wygenerowanie specjalnego pliku typu CRF, niezbędne- 
go dla otrzymania listingu z opisem odwołań przy 
użyciu dodatkowego programu CREF8O, 

asemblacja pliku źródłowego zawierającego instruk- 
cje mikroprocesora Z80, 

każdy przełącznik /P powoduje przeznaczenie do- 
datkowych 256 bajtów dla pracy stosu w czasie 
asemblacji. Parametr należy stosować wtedy, gdy 

w systemie występują błędy, 

inicjacja obszarów pamięci zarezerwowanych dyrekty- 
wą DS w taki sposób by komórki zawierały wartości 
zerowe, 

zakaz wyprowadzenia na listing fragmentów programu, 
które nie są asemblowane ze względu na warunkową 
asemblację. 


Możliwe jest jednoczesne wywoływanie i ustalanie sposobu 


pracy makroasemblera przez wypisanie w jednym wierszu 
zarówno dyrektywy wywołującej, jak i sterujęcej. 


Przykładowo: 


MRL , s WODA 


6.2. Sygnalizacja błędów 


6.2.1. Sposób sygnalizacji błędów 


Makroasembler generuje w czasie pracy dwa rodzaje 
komunikatów o błędach: 
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6.2.2. 
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- błędy programu źródłowego sygnalizowane na listingu 
w pierwszej kolumnie przy pomocy jednoliterowego 


kodu błędów, 


- błędy w postaci informacji wypisywanej na końcu 


listingu, związane z asemblacją. 


Jeśli listing jest wyprowadzony na konsolę, wówczas 


błędy te wyprowadzane są na konsolę razem z listingiem. 
Jeżeli listing nie jest wyprowadzony na konsolę, 


wówczas na konsolę są wyprowaszane te wiersze listingu, 
które mają zaznaczone błędy, a następnie jest wypisy- 
wana informacja o błędach umieszczona na końcu listingu. 


Kody błędów w listingu 


Kod błędu 


A 


Przyczyna 


Błąd argumentu dyrektywy. Zły 
format lub poza zakresem. 


Błąd zagnieżdrzenia warunkowej 
asemblacji: 

ELSE bez IF, ENDIF bez IF, dwa 
ELSE przy jednym IF, ENDC bez 
COND. 


Podwójnie zdefiniowany symbol. 
Odwołanie do symbolu, który 
został więcej niż raz zdefiniowa- 
ny. 

Błąd dotyczęcy nielegalnego 
użycia symbolu zewnętrznego. 
Wielokrotne definiowanie syunbolu. 
Występuje definiowanie symbolu, 
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który został poprzednio zdefinio- 
wany. 


Błędna liczba. Zwykle błędna 
cyfra, np. cyfra 8 w liczbie 
oktalnej. 


Słędny kod operacji lub błędna 
składnia, ENOM, LOCAL na zewnątrz 
bloku; SET, EQU lub MACRO bez 
nazwy, błędna składnia kodu 
operacji, błędna składnia w wy- 
rażeniu /np. opuszczone nawiasy, 
opuszczony cudzysłów/. 


Błąd przebiegu asemblera. 
Wartość etykiety lub nazwy okre- 
ślonej przez EQU jest różna w 
kolejnych przebiegach asenblacji, 


Błąd dotyczący przesuwalności 
/relokacji/. Nielegalne użycie 
przesuwalności w wyrażeniu, jak 
np. absolutna wartość - przesuwal- 
na wartość. 


Niezdefiniowany symbol. Symbol 
użyty w wyrażeniu jest niezdefinic 
wany. Dla niektórych dyrektyw w 
pierwszym przebiegu asemblacji 
jest drukowany błąd V, a błąd U 
dla drugiego przebiegu. 


Błąd wartości. Dyrektywa, która 
powinna dysponować znaną wartością 
symbolu w pierwszym przebiegu 
asemblacji /np. RADIX, .PAGE, DS, 
IF, IFE/ nie ma zdefiniowanej 

tej wartości. 
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Jeśli symbol ten zostanie zdefinio- 
wany później w programie, to przy 
drugim przebiegu asemblacji nie 
wystąpi błąd L'. 


. Informacje o błędach wyprowadzone na końcu listingu 


% BRAK KOMENDY END 


Brak dyrektywy END - dyrektywa opuszczona lub nie 
analizowana przez makroasembler, np. ze względu na 
występowanie we fragmencie programu nie podlegającym 
asemblowanym przy asemblacji warunkowej. 


NIEPRZERWANE ASSEM. WAR. 


Co najmniej jeden wskaźnik warunkowej asemblacji nie 
został zamknięty po dojściu do końca programu źródło- 
wegb. 


NIEPRZERWANE REPT /IRP/MACRO 


Co najmniej jeden w wyżej wymienionych bloków nie na 
zakończenia. 


ZBYT DUŻO ETYKIET 


Tablica symboli budowana w czasie asemblacji wyczerpała 
posiadający zasób pamięci. Najczęściej jest to związane 

z użyciem dużej liczby makrodefinicji. W pamięci są 
przechowywane makrodefinicje łącznie z komentarzami. 

Aby oszczędzić pamięć można komentarze w makrodefinicjach 


poprzedzać znakami ";; 


-- BŁEDY /ów/ -- OSTRZEŻENIA (EŃ ) 


Jest to ostatni wydruk makroasemblera po zakończeniu 
asemblacji. 
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Podawana jest łączna liczba wykrytych bezwzględnych 
błędów /--/ oraz ostrzeżeń, tj. błędów, które mogę, 
ale nie muszą dawać błędnego wyniku asenmblacji. 

Gdy nie wykryto żadnych błędów, wówczas drukowane 
jest "-- BŁĘDY (ÓW) *. 


6.3. Sposób wywoływania i sterowania pracą programu CREF80 


Program CREF80 stanowi pomicniczy program, stosowany 

w powiązaniu z programem makroasemblera M8O. 

CREF80 służy do otrzymywania listingu z dodatkowyni 
danymi, zawierającymi informacje o odwołaniach wewnątrz 
asemblowanego modułu programu źródłowego. 

Postać takiego listingu opisano w pkt. 5.3. 

Chcąc wykorzystać program CREF80 nalaży przy ustalaniu: 
warunków pracy makroasemblera użyć parametru /C /pkt. 
6.1./. Użycie tego parametru powoduje wygenerowanie 
przez makroasembler zamiast normalnego listingu /zbiór 
typu PRN/, specjalnego zbioru z odwołaniani, oznaczonego 
typem CRF. Dzięki temu po zakończeniu tak przeprowadzonej 
asemblacji można wywołać dodatkowy program CREF8O, 


Wywołanie programu CREF dokonuje się przez wprowadzenie 
zlecenia nierezydentnego: 


CREF8O 


W odpowiedzi na to program CREF80 zgłasza się przez 
wydrukowanie znaku gwiazdki. 

W celu uzyskania pliku zawierającego rozszerzony listing 
/oznaczony standardowo jako typ LST/ należy wprowadzić 

z konsoli /po gwiazdce/ linię dyrektywy 


« nazwa programu 
gdzie, nazwa programu oznacza nazwę pliku typu CRF, 
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który stanowi podstawę do uzyskania po przetwarzaniu, 
potrzebnego pliku z rozszerzonym listingien. 


Wywołanie programu CREF80 i podanie nazwy pliku typu 
CRF, może być też dokonane w jednym wierszu przez 
wprowadzenie z konsoli: 


CREF80 s nazwa programu 


Dla wyprowadzenia otrzymanego, rozszerzonego listingu 
bezpośrednio na drukarkę lub konso.ę systemową, należy 
przed znakiem równości wypisać nazwę urządzenia według 
oznaczeń przyjętych w systemie operacyjnym CP/J. 


Przykładowo, w celu wyprowadzenia na drukarkę rozsze- 
rzonego listingu, należy wprowadzić po zakończeniu 
asemblacji: 


CREF80 LST: = nazwa programu 


7. POSTAĆ PROGRAMU ŹRÓDŁOWEGO I DYREKTYWY 


7.1. Format programów źródłowych 


7.1.1. Uwagi ogólne 


Prograa źródłowy powinien być przygotowany jako ciąg 
istrukcji pisanych w języku makroasemblera dla 
mikroprocesora INTEL 8080 lub Z80. 


Zestawy instrukcji mnemonicznych dla obu tych 
mikroprocesorów /INTEL 8080 i Z80/ podano w Załącz- 
niku B. 
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Szczegóły dotyczące opisu listy rozkazów mikro- 
procesorów są zawarte w dostępnej dokumentacji 
dotyczącej tych mikroprocesorów. 

Dyrektywy /pseudoinstrukcje/ dla makroasenblera M80 
zostały opisane w dalszej części podręcznika 

a zestawienie dyrektyw podano w Załączniku A. 


Długość linii programu źródłowego nie może przeż.ra- 
czać 132 znaków. MBO przyjmuje i zachowuje znaki 
małych liter dla łańcuchów znaków i komentarzy, a 
dla symboli oznaczeń kodu operacji i dyrektyw pisa- 
nych z wykorzystaniem małych liter przeprowadza 
zmianę tych liter na duże. 


7.1.2. Instrukcje w języku makroasemblera 


Instrukcja programu źródłowego ma postać: 
etykieta : operator operandy komentarz 


Instrukcja nie musi zaczynać się w pierwszej kolumnie. 
Dla zwiększenia czytelności programu można stosować 
odstępy w postaci wielu spacji lub tabulację poziomą. 


Jeśli linia programowa posiada etykietę, wówczas 
etykieta występuje jako pierwsza w linii, a bezpośred- 
nio po niej występuje dwukropek. W przypadku, gdy po 
etykiecie występują dwa dwukropki, wówczas jest to 
równoważne deklaracji tej etykiety jako GLOBAL 
/patrz pkt. 7.3.2.7./. 


Przykładowo, zapis 


COS :: RET 


jest równoważny zapisowi 
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7.1.3. 


COS: GLOBAL COS 
RET 


Następną pozycją instrukcji po etykiecie /lub pierwszą 
jeśli nie występuje etykieta/ jest operator. 


Operatorem może być oznaczenie mnemnoniczne kodu opera- 
cji mikroprocesora INTEL 8080 lub Z80, dyrektywa 
/pseudoinstrukcja/, makrowywołanie lub wyrażenie. 
Kolejność oceny operatora jest następująca: 


1. makrowywołanie, 
2. mnemonik kodu operacji/dyrektywa, 
3. wyrażenie. 


Makroasembler w przypadku napotkania wyrażenia nie 
traktuje tego jako błąd, lecz tak, jakby to była 
instrukcja z dyrektywą DB /pkt. 7.3.2.1./. 

Operandy występujące po operatorze mają różną postać, 
odpowiednio do tego operatora. 

Komentarz zawsze jest rozpoczynany znakiem średnika 

i zakończony znakiem CR. 

Komentarz może występować w wierszu samodzielnie, 

lub też jako uzupełnienie do zdania występującego w 
danym wierszu. 

Rozszerzone komentarze mogą być wprowadzone dyrektywą 
COMMENT /pkt. 7.3.4.1./. 


Nazwy 
Nazwy dla makroasemblera M8O mogą być dowolnej długo- 


óci, jednak tylko cześć pierwszych znaków jest trakto- 
wanych jako znaczące. 
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Dopuszczalne jest stosowanie następujących znaków 
/w ramach przedziałów/ 


A-Z 0-9 g , ? o 


Dopuszczalne jest również stosowanie w nazwie znaku 
kreski podkreślającej -. Symbol nie może zaczynać się 
cyfrą. Przy czytaniu symboli małe litery są zamienia- 
ne na duże. 

Jeśli odwołanie do symbolu zakończone jest znakami, 
wówczas jest to równoważne deklarowaniu tego symbolu 
jako zewnętrznego /patrz dyrektywa EXT, pkt.7.3.2.6/. 


7.1.4. Stałe numeryczne 


Stałe numeryczne, jeśli nie jest to inaczej ustalone, 
są traktowane jako liczby dziesiętne. Zmiany (konwer- 
śji)nożna dokonać przy pomocy dyrektywy RADIX 

/pkt. 7.3.4.5./. Można ustalać dowolną podstawę 
liczbową z zakresu od 2 /binarną/ do 16 /heksadecynalnę/. 
Dla podstawy liczbowej większej od 10 stosuje się 
oznaczenia cyfr powyżej 9 przy pomocy liter A, B, C, D, 
E i F, Jeśli pierwsza cyfra w liczbie jest inna niż 

O - 9, wówczas zapis tej liczby powinien być poprze- 
dzony cyfrą O. 

Liczby są 16-to bitowyni wartościani bez znaku. 

Liczba jest traktowana jako zapis dla bieżącej, obo- 
wiązującej wartości podstawy, jeśli nie zaznaczono 
inaczej, w specjalny, niżej podany sposób: 


nnnnB dla liczby binarnej 
nnnnD dla liczby dziesiętnej 
nnnno dla liczby oktalnej 
nnnnQ 

nnnnH dla liczby heksadecynalnej 
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Xnnnn 


W przypadku przskroczenia przez liczbę wartości 
ponad 16 bitów, nadmiar jest ignorowany, a jako 
wynik traktuje się 16 najmniej znaczących bitów. 


Stałe znakowe 


Stała znakowa jest ciągien złożonym z zerowej liczby 
znaków, jednego lub dwóch znaków umieszczonych między 
znakami cudzysłowów / pojedyńczych lub podwójnych/ 

i występującym w złożonym wyrażeniu. 


Dla przykładu w zdaniu 


OB A +1 
A stanowi stałą znakową, lecz w zdaniu 
DB A 


A stanowi łańcuch znaków, ponieważ występuje w prostym 
wyrażeniu. 


Zasady stosowania ograniczników /delimiterów/ dla 
stałych znakowych i łańcuchów znaków są takie same. 


Stała znakowa zawierająca jeden znak posiada wartość 
odpowiadającą wartoóci kodu ASCII tego znaku. 

Oznacza to, że starszy bajt 16-to bitowej reprszenta- 
cji wartości jest równy zero, a młodszy bajt tej 
reprezentacji jest równy wartości kodu ASCII tego 
znaku. 


Przykładowo, wartością stałej A jest 41H. 


Stała znakowa zawierająca dwa znaki posiada wartość 
starszego bajtu, równą wartości kodu ASCII pierwszego 
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znaku, a wartość młodszego bajtu równą wartości kodu 
ASCII drugiego znaku. 

Dia przykładu, wartość stałej znakowej AB jest równa 
41H 2556+42H. 


7.1.6. Łańcuchy znaków 


Łańcuch znaków stanowi ciag zerowej lub większej 
liczby znaków umieszczony między znakami cudzysłowu 
/pojedyńczych lub podwójnych/. Cudzysłowy stanowią tu 
ograniczniki. Dla przedstawienia jednego znaku cudzy- 
słowu wewnątrz łańcucha muszą być użyte dwa kolejne 
znaki takiego cudzysłowu. 


Przykładowo zdanie: 


DB "TO JEST* "COS* "DLA MNIE” 
powoduje zapamiętanie łańcucha: 


TO JEST *COS" DLA MIE 
7.2. Wyznaczanie wartości wyrażeń 
7.2.1. Operatory arytmetyczne i logiczna 


Dopuszczalne jest stosowanie niżej podanych operatorów, 
wymienionych w kolejności priorytetu od najwyższegy do 


najniższego: 
NUE. 
LOW, HIGH 


x,/, MOD, SHR, SHL. 


EQ. NE, LT, LE, Gi, GE 
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NOT 
AND 
OR, XOR 


Dla zmiany kolejności działania operatorów można 
używać nawiasów. Przy wyznaczaniu wartości wyrażeń, 
fragmenty wyrażeń zawierające operatory o wyższym 
priorytecie są obliczone w pierwszej kolejności. 
Wszystkie operatory z wyjątkiem: +, -, x, /powinny 
być oddzielone od ich operandów co najmniej jedną 
spacją. 


Znaczenie poszczególnych operatorów jest następujące: 


NUL - daje wartość logiczną zależną od tego, co 
znajduje się na prawo od tego operatora do 
końca wiersza. 

Dyrektywa warunkowa /pkt. 7.3.7./. 

IF NUL argument 

jest nieprawdą, jeśli pierwszym znakiem argu- 
mentu jest inny znak niż średnik lub znak 
powrotu karetki CR. 


TYPE - daje bajt opisujący właściwości argumentu 
tego operatora. 
Argumentem może być dowolne wyrażenie. 
Gdy wyrażenie jest nieprawidłowe, otrzymywa- 
ny bajt ma wartość zero. Dwa najmłodsze 
bity otrzymanego bajtu określają odpowiednio 
tryb wyrażenia: 


O - tryb absolutny, 

1 - z przesuwalnym programem, 
2 - z przesuwalnyni danymi, 

3 - COMMON. 
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Najwyższy bit bajtu /80H/ jest równy i, 
jeśli wyrażenie jest zewnętrzne, a równy O 
gdy wyrażenie jest lokalne. 

Bit szósty /20H/ jest równy 1 tylko wtedy, 
gdy wyrażenie jest lokalnie definiowane. 


LOW - wydziela 8 najniższych bitów z 16-to bitowej 
wartości wyrażenia. 


HIGH - wydziela 8 najwyższych bitów z 16-to bitowej 
wartości wyrażenia. 


/ - dzielenie 


MOD - moduls. Dzieli lewy operand przez prawy 
operand i zwraca wartość stanowiącą resztę 
z tego dzielenia. 


SHR - przesunięcie w prawo. Po SHR jest podawana 
liczba całkowita, która określa liczbę 
przesunięć bitowych pozycji w prawo. 


SHL - przesunięcie w lewo. Po SHL jest podawana 
liczba całkowita, która określa liczbę 
przesunięć bitowych pozycji w lewo. 


- - minus unarny. Wskazuje, że zapisana z pra- 
wej strony wartość jest ujamna. 


+ - dodawanie 


- - odejmowanie 


Operatory dające wartości logiczne 1 /TRUE/ lub O 


/FALSE/ 

EQ - równy. Daje 1, gdy operandy są równe. 
NE - różny. Daje 1, gdy operandy sę różne. 
LT - mniejszy niż. Daje 1, gdy lewy operand 


jest mniejszy od prawego. 
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LE - mniejszy lub równy. Daje 1, gdy operard 
z lewej stronv jest mniejszy niż prawy 
operand lub równy. 


GT - większy. Daje 1, gdy lewy operand jest 
większy od prawego. 


GE - większy lub równy. Daje 1, gdy lewy operand 
jest większy niż 'prawy operand lub równy. 


KOT - operacja logiczna. Daje 1, gdy lewy operand 
jest równy 1 a prawy O lub gdy lewy operand 
jest równy O a prawy 1. 
Jeżeli oba operandy mają wartość O lub 
wartość 1, to uzyskuje się wynik O. 


AND - mnożenie logiczne. Daje 1, gdy oba operandy 
są równe 1. Obydwa operandy muszą być w 
trybie absolutnym. 


OR - suma logiczna. Daje 1, gdy jeden z operandów 
lub obydwa maję wartość 1. Obydwa operandy 
muszą być w trybie obsolutnyn. 


7.2.2. Tryby wyrażeń 


Symbole występujące w wyrażeniach jako operandy mogą 
być w jednym z poniższych trybów: 


trybie absolutnym, 
— przesuwalnymi danymi, 
- przesuwalnym programem /koden/, 

trybie COMMON. 

/peatrz pkt. 7.3.3. opisujący dyrektywy ASEG, 


CSEG i COMMON. 


w 
z 
z 
w 


ża PMAU.BOZZ-U? 3-4 


Symbole asemblowane przy działaniu dyrektywy ASEG są 

w trybie absolutnym, przy działaniu dyrektywy CSEG 

/co jest standardem, jeśli nie określono inna dyrekty- 
wą inaczej/ są w trybie z przesuwalnyn programem, a 

przy działaniu dyrektywy DSEG są w trybie z przesuwalny- 
mi danymi. 


Występowanie trybów COMMON w danym programie jest 
okraślone przez ilość bloków COMMON, które zostały 
nazwana przy pomocy dyrektywy COMMON. Dwa symbole 
COMMON nie sę w tym samym trybie, jeśli nie należę do 
tego samego bloku COMMON. 


Dla dowolnych operacji innych niż dodawanie lub odejmo- 
wanie operandy muszą być podane w trybie absolutnym. 


Dla operacji dodawania stosuje się następujące reguły: 


a/ co najmniej jeden z dwóch operandów powinien być 
w trybie absolutnym, 
b/ tryb absolutny + tryb x = tryb x. 


5la operacji odejmowania obowiązują następujące reguły: 
a/ tryb x - tryb absolutny = tryb x, 
b/ tryb x - tryb x = tryb absolutny /jeśli tryby po 
lewej stronie są 
takie same/. 


Każdy pośredni etap oceny wyrażenia musi spełniać 
powyższe zasady dotyczące trybów, gdyż w przeciwnyn 
przypadku jest sygnalizowany błąd. 


Przykładowo, jeśli PIK, LIS, ZEZ są symbolami w trybie 
przesuwalnym, wówczas wyrażenie 


PIK s LIS - ZEZ 


będzie sygnalizowane błędem R, ponieważ pierwszy krok 
/PIK + LIS/ powoduje dodawanie dwu relokowalnych 
wartości /jedna powinna być w trybie absolutnyn/. 
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7.2.3. 


7.2.4. 
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Trudność tę można pokonać przez dodanie nawiasów 
PIK » /LIS - ZEZ/ 


Powyższe wyrażenie jest akceptowane, ponieważ /LIS - 
ZEZ/ powoduje wygenerowanie wartości w trybie absolutnym, 
która w następnym kroku jest dodawana do wartości PIK 

w trybie z przesuwalnym programem, 


Symbole zewnętrzne 


Niezależnie od trybu, w którym występuje, symbol może 

być określony jako zewnętrzny /external/ lub nie /patrz 
dyrektywa EXT/BYTE EXT, pkt. 7.3.2.6/. Pojęcie symbolu 
zewnętrznego oznacza, że jest on zdefiniowany na zewnątrz 
modułu programu, w którym jest używany. 

W module tym, gdzie jest definiowany, symbol taki powi- 
nien być zadeklarowany jako GLOBAL /PUBLIC/. 


Dla symboli zewnętrznych obowiązuję następujące zasady 
stosowania ich w wyrażeniach: 


- symbole zewnętrzne mogą być w wyrażeniach zawieraję- 
cych tylko operatory: +, -, x, /, MOD, HIGH, LOW, 


- wyrażenie, w którym występują symbole zewnętrzne ma 
wartość, która też jest typu zewnętrznego. 


Kody operacji jako operandy 


Kody operacji mikroprocesora INTEL 8080 mogą być 
używane jako jednobajtowe operandy. 


Oto przykłady poprawnych zapisów: 


MVI A /JMP/ 
CPI /INX H/ 
MVI C, /MOV A,B/ 


ADI /CPI/ 
ACI /LXI B/ 
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Tylko pierwszy bajt w instrukcji może być wykorzysty- 
wany przy zapisie, gdyż w przeciwnym przypadku jest 
sygnalizowany błąd. 


Np. niepoprawne jest używanie jako operandów: /CPI 5/, 
/LXI B, COSA1/lub /JIMP COS2/. 


Kody operacji używane jako operandy nie muszą być 
zapisywane w nawiasach. 


UWAGA: Przy pracy makroasemblera w trybie Z80 nie 
można używać kodów operacji jako operandów. 


7.3. Dyrektywy w programie źródłowym 
7.3.1. Dyrektywy wyboru zestawu instrukcji 


7.3.1.1..Z80 - instrukcje mikroprocesora Z80 


Dyrektywa .280 jest bez argumentów i umożliwia przyj- 
mowanie przez makroasembler MB8O instrukcji odpowiada- 
jących mikroprocesorowi Z80 /patrz Załęcznik B/. 
Makroasembler może pracować też w trybie .Z80 przez 


dodanie parametru /Z przy wywołaniu makroasenblera 
/pkt. 6.1/. 


7.3.1.2. .8080 - instrukcje mikroprocesora 8080 


Dyrektywa .8080 jest bez argumentów i umożliwia 
przyjmowanie przez makroasembler MBO instrukcji 
odpowiadających mikroprocesorowi INTEL 8080 /patrz 
Załącznik B/. 

Jest to standardowy sposób pracy makroasemnblera M8O, 
gdy brak jest dyrektywy wyboru zestawu instrukcji. 


7110.5022—01 33—0 25 


7.3.2. Dyrektywy definiowania danych i symboli 


Wszystkie podane niżej dyrektywy definiowania danych 
i symboli mogą być stosowane zarówno w programach dla 
mikroprocesora 8080, jak i Z80, z wyjątkiem dyrektywy 
SET, która jest niedopuszczalna dla 280. 

Gwiazdkami z lewej strony oznaczono dyrektywy zwykle 
stosowane dla Z80. Brak gwiazdki oznacza dyrektywę 
stosowaną dla 8080, 


7.3.2.1. DB - definiowanie bajtów danych 


Postać: 


DB wyrażenie, wyrażenie ... 
DEFB wyrażenie wyrażenie ... 
DB łańcuch łańcuch ... 
DEFM łańcuch łańcuch ... 


Argumentem dla dyrektywy może być wyrażenie lub 
łańcuch. 

Dyrektywa powoduje zapamiętanie wartości wyrażeń 
lub łańcuchów znaków w kolejnych komórkach pamięci, 
poczynając od komórki wyznaczonej przez bieżącą 
wartość licznika komórek. 


Wyrażenie powinno odpowiadać wartości jednego bajtu 
/jeśli przekracza 255, sygnalizowany jest błąd A/. 


Znaki występujące w łańcuchach sę zapamiętywane w 
kolejności występowania, przy czym każdemu znakowi 
odpowiada jeden bajt z najbardziej znaczącym bitem 
równym O. 
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7.3.2.2. 


7.3.2.3:. 


Przykład asemblacji: 


0000 * 41 42 DB AB 
0002" 42 DB AB AND OFFH 
0003 * 41 42 43 DB ABC 


DC - definiowanie znaków 


Postać: 
DC łańcuch 


Dyrektywa DC powoduje zapamiętanie znaków łańcucha 

w kolejnych komórkach pamięci, poczynając od bieżącej 
wartości licznika komórek. 

Podobnie jak dla dyrektywy OB znaki są zapamiętywane 
w kolejności występowania, przy czym znakowi odpowia- 
da jeden bajt z najbardziej znaczącym bitem równym 
zero. Jednak w odróżnieniu od dyrektywy DB, dyrektywa 
DC powoduje zapamiętanie ostatniego znaku łańcucha w 
postaci bajtu z najbardziej znaczącym bitem równym 
jeden. W przypadku, gdy argumertem dyrektywy DC jest 
pusty łańcuch, wówczas sygnalizowany jest błąd. 


DS - definiowanie bajtów pamięci 
Postać: 
DS wyrażenie, wartość 


DEFS wyrażenie wartość 


Dyrektywa DS rezerwuje obszar pamięct o ilości 
bajtów wyznaczonej wartością wyrażenia. 
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7.3.2.4. 


7.3,2.5. 


Wartość tego wyrażenia przy pierwszym przebiegu 
asemblacji powinna być możliwa do określenia, gdyż 
w przeciwnym przypadku sygnalizowany jest błąd. 


Jeżeli wymagane jest, aby zarezerwowany obszar pa- 
mięci miał komórki o ustalonej zawartości, wówczas 
należy określić również wartość odpowiadającą temu, 
co jest umieszczone we wszystkich komórkach. 

Jeżeli nie podano wartości w dyrektywie, wówczas 
obszar zarezerwowanych komórek nie ulega zmianie 
/nie jest inicjowany przy ładowaniu programu wyniko- 
wego/. 

Rezerwowany obszar komórek może być zerowany przez 
podanie wartości równej zero lub użycie parametru 
/M przy wywołaniu makroasemblera /pkt. 6.1/. 


DW - definiowanie słów 


Postać: 


OW wyrażenie, wyrażenie ... 


DEFW wyrażenie wyrażenie ... 


Dyrektywa DW powoduje zapamiętanie wartości wyrażeń 
w kolejnych komórkach pamięci, poczynając od komórki 
wyznaczonej przez bieżącą wartość licznika komórek. 
Wartości wyrażeń są określone jako zawartości słów 
dwubaj towych. 


EQU - przyrównanie 
Postać: 


nazwa EQU wyrażenia 
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Dyrektywa EQU przypisuje wartość określoną przez 
wyrażenie symbolowi określonemu przez nazwę. 

Jeśli wyrażenie jest typu zewnętrznego, wówczas jest 
sygnalizowany błąd. Jeżeli symbol posiada już war- 
tość inną, niż określa to wyrażenie, wówczas sygna- 
lizowany jest błąd M. 


7.3.2.6. EXT/BYTE EXT - zewnętrzny symbol 


Postać: 

EXT nazwa , nazwa ... 
EXTRN nazwa , nazwa «.. 
EXTERNAL nazwa , nazwa ... 
BYTE EXT symbol 


BYTE EXTRN symbol 


BYTE EXTERNAL symbol 


Dyrektywy powyższe stanowią deklaracje symbolu 
/symboli/, który jest zewnętrzny, tzn. jest zdefinio- 
wany w innym module progranu. 

Jeśli symbol ten jest zdefiniowany w bieżącym module 
programu, wówczas sygnalizowany jest błąd M. 


Zewnętrzne symbole mogą być określone przez dwa lub 
jeden bajt /nazwy dyrektyw z "BYTE"/. 

Dla wszystkich zewnętrznych symboli tylko 6 pierwszycn 
znaków jest brane pod uwagę a reszta jest pomijana. 


Odwołanie do nazwy, po której bezpośrednio zapisano 
dwa znaki // // /np. NAZWA // // /. jest równo- 
ważne deklarowaniu tej nazwy jako zewnętrznej. 
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7.3.2.7. GLOBAL - globalny symbol 


Postać: 


ENTRY nazwa „, nazwa ... 
GLOBAL nazwa „,„, nazwa ... 


PUBLIC nazwa , nazwa ... 


Dyrektywy powyższe stanowią deklaracje nazw, które są 
traktowane jako globalne, to znaczy są dostępne nie 
tylko w danym module programu, w którym występują, 
ale są również udostępnione innym modułom programów 
/w trakcie działania programu łącząco-ładującego 
L80/. 

Przy rozpatrywaniu nazwy globalnej tylko 6 pierwszych 
znaków jest branych pod uwagę a reszta jest pomijana. 


7.3.2.8. SET - ustawianie 
Postać: 


nazwa SET wyrażenie /nie używane dla trybu pracy 
.Z80/ 
nazwa DEFL wyrażenie 


nazwa ASET wyrażenie 


Dyrektywy powyższe przypisują wartość określoną 
przez wyrażenie danej nazwie. 

Nazwa może być etykietą, symbolem lub zmienną 

i może występować w wyrażeniach. 

Po nazwie nie powinien występować dwukropek. 

Gdy wyrażenie jest zewnętrzne, sygnalizowany jest 
błąd. 
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Dyrektywy SET nie wolno stosować w trybie pracy 
makroasemblera .Z80, gdyż jest ona mnemonikiem 
instrukcji dla z8o0. 

Można w tym przypadku używać dyrektyw DEFL i ASET. 
Działanie dyrektywy SET jest podobne do dyrektywy 
EQU, z tym tylko wyjątkiem, że określona nazwa dla 
SET może mieć nadawane różne wartości przez wielokro- 
tne użycie dyrektywy SET /lub DEFL, ASET/, a dyrekty- 
wą EQU można nadawać wartość danej nazwie tylko raz. 


7.3.3. Dyrektywy trybu asemblacji 


W czasie asemblacji wartości symboli są określone 
odpowiednio w odniesieniu do licznika komórek /liczni- 
ka rozkazów/ pamięci, w której mają być umieszczone. 
Tryb pracy asemblera w momencie analizy danej instruk- 
cji programu źródłowego decyduje o miejscu pamięci, 

w którym ma być umieszczony otrzymany kod wynikowy. 

Kod wynikowy może być umieszczony w ściśle określonych 
przez programistę komórkach pamięci i wówczas jest to 
tzw. kod absolutny. Obok tego występuje też tzw, kod 
przesuwalny /relokowalny/ odpowiadający temu, że dopie- 
ro na jego podstawie w procesie otrzymywania ostatecz= 
nego kodu wynikowego następuje bezwzględne przyporządko- 
wanie określonym fragmentom programu źródłowego, określo- 
nych miejsc w pamięci. 

Oprócz powyższego, istnieje możliwość przyporządkowywa- 
nia otrzymanego kodu przesuwalnego do wybranych obsza- 
rów pamięci, zwanych segmentami i odpowiadających 
docelowo rozdzieleniu pamięci operacyjnej na pamięć 

typu RAM /z możliwością odczytu i zapisu/ oraz 

ROM/PROM /tylko odczytywalną, bez możliwości zapisu/. 
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Rozróżniamy segment odpowiadajęcy asemblacji w trybie 
przesuwalnego programu /instrukcji/, intencjonalnie 
związany z pamięcią ROM oraz segment odpowiadający 
asemblacji w trybie przesuwalnych danych, intencjonal- 
nie związany z panięcią RAM. 


Niezależnie od tego istnieje potrzeba, aby różne 

moduły programu asemblowane oddzielnie, posiadały przy 
współpracy wspólne, jednoznacznie określone obszary 
pamięci. Uzyskuje się to dzięki wprowadzeniu asemblacji 
wybranych odcinków programu w trybie zwanym COMMON. 
Stąd w czasie asemblacji mogą wystąpić 4 tryby asem- 
blacji: 


- tryb absolutny, 

- tryb przesuwalnego programu, 
- tryb przesuwalnych danych, 

- tryb COMMON. 


Każdy z powyższych trybów asemblacji jest wyznaczony 
przez wystąpienie odpowiedniej dyrektywy, ustalającej 
ten tryb. 

Określony tryb asemblacji obowiązuje aż do wystąpienia 
następnej dyrektywy zmieniającej ten tryb asemblacji. 


Gdy rozpoczęła się asemblacja i jeśli nie została użyta 
dyrektywa ustalająca tryb asemblacji, to obowiązuje tryb 
przesuwalnego programu. Jest to warte podkreślenia, 

gdyż dla innych makroasemablerów, dających przesuwalny 
kod jako stan pierwotny występuje zwykle asemblacja 

w trybie absolutnym. 
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7.3.35.1. ASEG - absolutny tryb asemblacji 


Dyrektywa ASEG powoduje rozpoczęcie asemblacji w 
trybie absolutnym. Jeśli nie jest ustalone inaczej, 
pierwsza komórka pamięci, w której jest umieszczony 
kod wynikowy, ma adres O. 

Ponieważ najniższe adresy w pamięci są zarezerwowane 
dla systemu operacyjnego, zaleca się, aby po dyrekty- 
wie ASEG stosować dyrektywę ORG, ustalającą adres 
początkowy o wartości 103H lub większej. 


Dyrektywa ASEG nie ma żadnych parametrów. 


7.3.3.2. CSEG - asemblacja w trybie przesuwalnego programu 


Dyrektywa CSEG powoduje rozpoczęcie asemblacji w 
trybie przesuwalnego programu. 

Jeśli nie jest użyta dyrektywa ORG, translacja prze- 
biega tak, jakby pierwsza komórka pamięci /w segmencie 
przesuwalnego programu/, miała mieć adres względny O. 
Zmianę tego adresu można dokonać przez użycie dyrekty- 
wy ORG po dyrektywie CSEG. 

Należy jednak pamiętać, że dyrektywa ORG w tym przy- 
padku nie ustala absolutnego adresu w segmencie prze- 
suwalnym progranu. 

Dyrektywa ORG powoduje natomiast dodanie do bieżącej 
wartości licznika komórek w segmencie przesuwalnego 
programu, wartości będącej parametrem tej dyrąęgtywy. 


Przy rozpoczynaniu asenblacji, założony stan początko- 
wy jest taki, jak by była użyta dyrektywa CSEG. 


Dyrektywa CSEG nie ma żadnych parametrów. 
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7.3.3.3. 


7.3.3.4. 
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DSEG - asemblacja w trybie przesuwalnych danych 


Dyrektywa BSEG powoduje rozpoczęcie asemblacji w 
trybie przesuwalnych danych. 

Jeśli nie jest ustalone inaczej, adres pierwszej 
komórki pamięci /w segmencie przesuwalnych danych/, 
w której umieszczony jest przesuwalny kod wynikowy, 
wynosi O. 

Zmiany tego adresu można dokonać przez użycie dyrek- 
tywy ORG po dyrektywie DSEG. 

Należy jednak pamiętać, że dyrektywa ORG w tym przy- 
padku nie ustala absolutnego adresu w segmencie prze- 
suwalnych danych. 

Dyrektywa ORG powoduje natomiast dodanie do bieżącej 
wartości licznika komórek w segmencie przesuwalnych 
danych wartości, będącej parametrem tej dyrektywy. 
Dyrektywa DSEG nie ma żadnych parametrów. 


COMMON - asemblacja w trybie COMMON 
Postać: 
COMMON /nazwa bloku/ 


Dyrektywa COMMON tworzy wydzielony blok w pamięci, 
stanowiący wspólny obszar do współpracy różnych 
modułów programowych. 

Bloki w pamięci tworzone są oddzielnie dla każdego 
COMMON o określonej nazwie. 

Jeśli w dyrektywie nie występuje nazwa bloku lub 
zamiast nazwy występują spacje, to blok COMMON 
stanowi COMMON bez nazwy. 
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7.3.3.5. 


Zdania, które są asemblowane w trybie COMMON 
odpowiadają zajmowaniu wydzielonego obszaru pamięci 
/dane, tablice, zmienne/ i nie stanowią instrukcji 
wykonywanych przez mikroprocesor. 


Po wystąpieniu dyrektywy COMMON rozpoczyna się 
asemblacja kolejnych zdań programu źródłowego z 
umieszczeniem wyniku asemblacji w obszarze panięci, 
przeznaczonym dla bloku COMMON o określonej nazwie. 
Asemblacja do bloku COMMON kończy się po wystąpieniu 
dyrektywy zmieniającej tryb ssemblacji. 

Długość bloku COMMON jest uzależniona od asemblowa- 
nych zdań. 

Bloki COMMON o tej samej nazwie, asemblowane dla 
różnych modułów programu mogą mieć różne długości. 

W tym przypadku, w czasie działania programu łączą- 
co-ładującego L80 moduł z najdłuższym blokiem 

COMMON powinien być ładowany w pierwszej kolejności. 


Omawiane bloki COMMON mogę też służyć do współpracy 
z programami pisanymi w języku FORTRAN. 


ORG - ustawianie licznika komórek 
Postać: 
ORG wyrażenie 


Dyrektywa ORG służy do zmiany zawartości licznika 
komórek. 

Przy asenblacji w trybie absolutnym licznik komórek 
jest ustawiony na wartość odpowiadającą wartości 
wyrażenia, będącego parametrem dyrektywy ORG. 
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7.3.3.6. 


Przy asemblacji w trybie przesuwalnego programu 
/CSEG/, przesuwalnych danych /DSEG/ i w trybie 
COMMON, licznik komórek odpowiadający danemu trybo- 
wi aseublacji jest zwiększany o wartość określoną 
przez parametr dyrektywy ORG. 


Wszytkie nazwy występujące w wyrażeniu powinny mieć 
wartości możliwe do określenia w pierwszym przebiegu 
makroasemblera i powinny to być wartości absolutne 
lub tego samego rodzaju co tryb asemblacji. 


„PHASE/ .DEPHASE - relokowanie 


Postać: 


„PHASE wyrażenie 


„DEPHASE 


Dyrektywa .PHASE pozwala na umieszczenie kodu wyni- 
kowego w jednym obszarze, a wykonanie go w innym 
obszarze począwszy od adresu określonego przez 
wartość wyrażenia. Powinno to być wyrażenie abso- 
lutne. Stowarzyszona dyrektywa .DEPHASE służy do 
wskazania końca bloku programu, którego kod ma być 
relokowany. 

Tryb asemblacji dla zdań wewnątrz relokowanego 
odcinka programu jest absolutny. 

Wydzielenie bloku „PHASE...  .DEPHASE umożliwia 
wykonanie wybranego bloku programu dla wybranych 
adresów, zdefiniowanych jako absolutne. 
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7.3.4. Dyrektywy dotyczące pliku z programem źródłowym 
7.3.,4.1. „COMMENT - długi komentarz 


Postać: 


„COMMENT ogranicznik tekst ogranicznik 


Dyrektywa .COMMENT umożliwia wprowadzenie do tekstu 
źródłowego programu długich komentarzy, obejmujących 
też wiele wierszy. Uwalnia ona od obowiązku rozpoczy- 
nania wiersza komentarza przez znak średnika. 
Pierwszy niepusty znak występujący za nazwą dyrekty- 
wy jest traktowany jako ogranicznik. Tekst za tym 
ogranicznikiem traktowany jest jako komentarz aż do 
wystąpienia powtórnego znaku ogranicznika. 


7.3.4.2. END - koniec programu 


Postać 
END wyrażenie 


Dyrektywa END określa koniec programu źródłowego. 
Jeżeli dyrektywa ta nie występuje, wówczas wypisywa- 
na jest informacja o błędzie na końcu listingu /jako 
ostrzeżenie/. Wyrażenie jeżeli występuje określa 
adres, który program łącząco-żadujący przyjmuje jako 
adres startu programu. Wówczas pod adresem 100H 
umieszczona jest instrukcja skoku mikroprocesora 
8080 /JMP/ pod ten adres. 
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7.3.4.3. 


7.3.4.4. 


INCLUDE/MACLIB - dołącz plik 


Postać: 


INCLUDE nazwa pliku 
$INCLUDE nazwa pliku 
MACLIB nazwa pliku 


Powyższe dyrektywy dołączają w określone miejsce 
programu źródłowego fragnenty programu w postaci 
źródłowej z pliku o określonej nazwie w argunencie 
dyrektywy. 

Z założenia program dołączany jest w pliku typu MAC. 
Jeśli typ pliku, z którego jest dołączany fragment 
programu jest inny, wówczas należy podać ten typ 

w dyrektywie. 

Nie wolno zagnieżdżać dyrektyw do łączenia pliku. 
Użycie takiej operacji sygnalizuje błąd O. 

Jeśli dołączany plik nie istnieje, wówczas jest 
sygnalizowany błąd V. 


Na listingu dołączony fragment programu źródłowego 
jest oznaczony literą C, drukowanę w każdym wierszu 
między uzyskanym kodem wynikowym i zawartością 
wiersza programu źródłowego. 


NAME - nazwa modułu 
Postać: 
NAME / nazwa modułu 


Dyrektywa NAME nadaje nazwę modułowi programu. 
Wypisanie nawiasów i znaków cudzysłowu jest konie- 
czne. 
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Jako nazwę modułu używa się tylko 6 pierwszych 
znaków podanej nazwy. 

Moduł może mieć określonę nazwę również dyrektywą 
TITLE. 

Jeśli nie użyto żadnej z tych dyrektyw, wówczas 
moduł otrzymuje nazwę odpowiadającą nazwie pliku 
z programem źródłowym. 


7.3.4.5. .RADIX - podstawa liczb 


Postać: 
„RADIX wyrażenie 


Dyrektywa .RADIX pozwala ustalać podstawę liczb 
występujących w programie źródłowym, w zakresie 

od 2 do 16. Standardowo, jeżeli nie określono 
inaczej, wszystkie stałe są przedstawiane w postaci 
dziesiętnej. 

Wartość wyrażenia będącego argumentem tej dyrektywy 
jest traktowana zawsze jako dziesiętna reprezenta- 
cja, niezależna od bieżącej podstawy liczbowej w 
programie. 


Dyrektywa .RADIX nie wpływa na postać listingu. 

Przy ustalonej tą dyrektywą podstawie liczb nie 
trzeba specjalnie oznaczać zapisanych liczb o tej 
podstawie. 

Liczby o innej podstawie trzeba wyróżniać specjalnymi 
oznaczeniemi /pkt. 7.1.4/. 
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7.3.4.6. 


„REQUEST - moduły związane 
Postać: 
„REQUEST nazwa pliku nazwa pliku ... 


Dyrektywa ta jest przeznaczona do wykorzystania 
podczas działania programu łącząco-=ładującego L8O. 
Daje ona informację dla programu łącząco-ładującego 
o tym, że w przypadku wystąpienia zewnętrznych 
symboli, które są niezdefiniowane w zasenblowanyn 
module programu, należy dla określenia wartości tych 
symboli wykorzystać dodatkowe moduły podane tą dy- 
rektywą. 


Nazwy plików nie wymagają określenia typów tych 
plików, a które powinny być z założenia typu REL. 


7.3.5. Dyrektywy sterujące listingiem 


7.3.5.1. 


PAGE/ x EJECT - nowa Strona 


Postać: 

PAGE wyrażenie 

EJECT wyrażenie /dyrektywa dla trybu pracy 
$ EJECT .Z80, jedna gwiazdka sta- 


nowi część dyrektywy/ 


Dyrektywy te powodują wyprowadzenie nowej strony 
listingu. 

Znak nowej strony w listingu jest umieszczony przy 
końcu strony. Jeśli jest podana wartość wyrażenia, 
to okreóla ona wielkość nowej strony /w wierszach 
na stronę/ i powinna być z zakresu od 10 do 255. 
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7.3.5.2. 


7.3.5.3. 


Gdy nie podano wielkości nowej strony, to wynosi 
ona 50 wierszy na stronę. 

Makroasembler powoduje przejście do drukowania 
nowej strony po zadrukowaniu 58 wierszy. 


TITLE - tytuł 
Postać: 
TITLE tekst 


Dyrektywa TITLE określa tytuł, który jest drukowany 
w pierwszym wierszu każdej strony listingu. 

Jeżeli nie użyto dyrektywy NAME, wówczas 6 pierwszych 
znaków tytułu jest wykorzystywane jako nazwa modułu. 
Gdy nie użyto dyrektywy TITLE ani dyrektywy NAME, 

to nazwa modułu jest utworzona z nazwy pliku pro- 
gramu źródłowego. 


Dyrektywa TITLE powinna być użyta tylko raz. 
W przypadku kilkakrotnego jej użycia sygnalizowany 
jest błąd Q. 


SUBTTL / $ TITLE - podtytuł 


Postać: 


SUBTTL tekst 


O TITLE tekst 


Dyrektywy te określają podtytuł, który jest druko- 
wany na każdej stronie listingu, w drugim wierszu. 
Tekst podany jako argument jest obcinany po pier- 
wszych 60 znakach. W programie może wystąpić dowol- 
na liczba dyrektyw tego typu. 
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7.3.5 .4, 


7.3.5.5. 


42 


Po napotkaniu nowej dyrektywy SUBTTL, makroasembler 
zamienia dotychczasowy podtytuł na nowo otrzymany. 


Aby zaprzestać drukowania podtytułu należy użyć 
dyrektywę SUBTTL z zerową długością łańcucha dla 
tekstu /tz. bez argumentu/. 


„LIST i .XLIST - włączenie i wyłączenie listingu 
Postać: 
„LIST - włączanie listingu 


„XLIST - wyłęczanie listingu 


Jako sytuację standardową przyjmuje się, że listing 
jest włączony. 

Jeśli w dyrektywie sterującej pracą makroasemblera 
/pkt. 6.1/ wyspecyfikowano plik listingu, to będzie 
on tworzony. 

Gdy w programie źródłowym wystąpi .XLIST, wówczas 
listing nie jest wyprowadzany. 


Działanie .XLIST pozostaje w mocy do wystąpienia 
dyrektywy .LIST. 


Jeżeli wystąpi .XLIST, działania innych dyrektyw 
dotyczących listingu, z wyjątkiem LIST nie powodują 
wyprowadzenia listingu. 


„PRINTX - wydruk 


Postać: 


„PRINTX ogranicznik tekst ogranicznik 
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7.3.5.6. 


Dyrektywa ta umożliwia wyprowadzenie na konsolę 
systemową tekstu występującego jako argument 
dyrektywy. 

Pierwszy niepusty znak występujący za nazwą dyrekty- 
wy jest traktowany jako ogranicznik. Dalej występu- 
jący tekst jest drukowany aż do napotkania powtórne- 
go znaku ogranicznika. 


.PRINTX jest użyteczna dla monitorowania przebiegu 
pracy przy długiej asemblacji lub dla wyprowadzenia 
wartości argumentów dla warunkowej asemblacji. 
Dyrektywa powoduje wydruk tekstów dla obu przebiegów 
asemblacji. 

Jeżeli potrzebny jest wydruk tylko dla jednego z 
przebiegów, należy użyć dyrektyw warunkowej asembla- 
cji IF1 lub IF2, w zależności od tego, dla którego 
przebiegu powinien być wyprowadzony tekst. 


„SFCOND - wstrzymanie listingu nieasemblowanych 
fragmentów 


Postać: 
.„SFCOND 


Dyrektywa ta powoduje wstrzymanie wyprowadzenia na 
listing fragmentów programu niepodlegających asembla- 
cji /w wyniku asenblacji warunkowej/. 
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7.3.5.7. .LFCOND - listing nieasemblowanych fragmentów 


Postać: 
„LFCOND 


Dyrektywa ta powoduje podjęcie wyprowadzenia na 
listing fragmentów programu niepodlegających asembla- 
cji /w wyniku asemblacji warunkowej/. 


7.3.5.8. .TFCOND - przełączenie listowania nieasemblowanych 
fragmentów 


Postać: 


„TFCOND 


Dyrektywa ta powoduje przełączenie stanu listowanie/ 
nielistowanie nieasemblowanych fragmentów związanych 
z asemblacją warunkową. Stan początkowy jest ustalo- 
ny przez parametr /X, w dyrektywie sterującej pracą 
makroasenblera /pkt. 6.1/. 

Jeżeli parametr ten występuje, wówczas użycie 
„TECOND powoduje listowanie nieasemblowanych frag- 
metnów. 

Jeżeli parametr /X nie występuje, użycie .TFCOND 
wstrzymuje wyprowadzenie listingu nieasemblowanych 
fragmentów progranu. 


Dyrektywa .TFCUND działa niezależnie od dyrektyw 
„LFECOND i .SFCOND. 
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7.3.5.9. .XALL - listowanie wszystkich fragmentów poza 
nieasemblowanyni 


Postać: 


.XALL 

Dyrektywa ta powoduje wyprowadzenie na listing 
rozwinięć makroinstrukcji i powtarzanych bloków, 
ale bez wyprowadzania fragmentów warunkowo nieasem- 
blowanych. 

Przy rozpoczynaniu działania makroasemblera, stan 


odpowiadający tej dyrektywie występuje jako standar- 
dowy. 


7.3.5.10. .LALL - pełne listowanie rozwinięć makroinstrukcji 
i powtarzanych bloków 
Postać: 
„LALL 


Dyrektywa ta ustala wyprowadzanie na listing 
rozwinięć makroinstrukcji i powtarzanych bloków, 
łącznie z fragmentami warunkowo nieasenblowanymi. 


7.3.5.11. .SALL - wstrzymanie listowania rozwinięć 
Postać: 
„SALL 


Dyrektywa wstrzymuje wyprowadzenie na listing 
rozwinięć makroinstrukcji i powtarzanych bloków. 
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7.3.5.12. .XCREF i CREF - wyłęczenie i włączenie generowania 
tablicy odwołań 


Postać: 


„XCREF - wyłączenie generowania tablicy odwołań 


„CREF  - włączanie generowania tablicy odwołań 


Dyrektywy służą do włączania i wyłączania generowa- 

nia tablicy odwołań. Tablica odwołań przygotowywana 
jest tylko wówczas, gdy przy wywoływaniu makroasem- 

blera użyto parametru /C/ ptk. 6.1/. 

Jeżeli parametru tego nie użyto, to dyrektywy 

„XCREF i .CREF nie wpływają na pracę makroasemblera. 


Dyrektywy .XCREF i .CREF służę do selektywnego 
wybrania tych fragmentów programu źródłowego, dla 
których ma być utworzona tablica odwołań /pkt. 6.3/. 


7.3.6. Dyrektywy dla makroinstrukcji i powtórzeń bloku 


Makroinstrukcje pozwalają definiować bloki złożone 

z instrukcji makroasemblera, które mogą być replikowa- 
ne bez potrzeby ponownego ich wypisywania. 

Podobnie można stosować wielokrotne powtarzanie blo- 
ków przy użyciu specjalnych dyrektyw powtórzeń. 


W makroinstrukcjach są stosowane specjalne, niżej 
podane oznaczenia: 


8 - wykorzystywany w rozwinięciu makroinstrukcji 
do realizacji konkatenacji tekstów lub 
symboli. Jeśli ma nastąpić podstawienie dla 
parametru formalnego w postaci łańcucha 
znaków w cudzysłowiu, wówczas łaricuch ten 
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powinien mieć na pierwszej pozycji umieszczo- 
ny znak 8. 


;; > jeżeli w bloku komentarz poprzedzony jest 
dwoma znakami średników /a nie tylko jednym/, 
to nie jest on uwzględniany w czasie asenbla- 
cji przy rozwijaniu tego bloku, tj. nie poja- 
wia się w części listingu przedstawiającej 
rozwinięcia. 


|! - wykrzyknik jest stosowany dla pokazania, że 
następny znak należy traktować dosłownie, tj. 
jako określona reprezentacja kodu. 


% - znak procentu jest stosowany przy wywoływaniu 
makroinstrukcji, do napisania przed wybranym 
paraaetrem aktualnym /wyrażeniem/. 

Zapis teki powoduje zamianę tego parametru 

na liczbę przedstawiającą jego wartość, 

według bieżącego sposobu przedstawienia liczb. 
Liczba otrzymana jest podstawiona w niejscu 
parametru formalnego. 


7.3.6.1. MACRO i ENDM - definiowanie aakroinstrukcji 


Postać: 


nazwa MACRO paranetr formalny parametr formalny ... 


ENDM 
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Dyrektywa MACRO służy do zdefiniowania ciągu instruk- 
cji zakończonych dyrektywą ENDM. 

Ciąg tych instrukcji stanowi ciało makroinstrukcji. 
Nazwa poprzedzająca dyrektywę MACRO stanowi nazwę 
makroinstrukcji. 

Nazwa ta może być dowolnej długości lecz tylko 16 
pierwszych znaków jest uwzględnianych. 

Nazwa ta występuje podobnie do etykiety z tym, że 
nie występuje po niej znak dwukropka. 

Po zdefiniowaniu makroinstrukcji nazwa tej makro- 
instrukcji służy do jej wywoływania. 

Parametr formalny makroinstrukcji może zawierać do 
32 znaków i przy wywoływaniu makroinstrukcji jest 
zamieniany na odpowiedni parametr aktualny, według 
kolejności występowania na liście parametrów. 
Liczba paraaetrów formalnych jest ograniczona tylko 
przez długość wiersza /programu źródłowego/. 


Postać wywołania makroinstrukcji jest następująca: 
nazwa parametr aktualny parametr aktualny ... 


Liczba parametrów aktualnych w wywołaniu makroinstruk 
cji nie musi być równa liczbie parametrów formalnych. 
Jeżeli parametrów aktualnych jest więcje, to nadmia- 

rowe parametry są ignorowane. 

Jeśli paranetrów aktualnych jest mniej, to pozostałe 

parametry na liście są traktowane jako nie występują- 
ce. 


Przy ujęciu w nawiasy ostrokątne kilku parametrów 

z listy paranetrów w czasie wywoływania makroinstruk- 
cji, cała zawartość tego nawiasu jest przekazywana 
jako jeden paranetr. 
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Makrodefinicja przy asemblacji nie jest translowana. 
Przy wywoływaniach makroinstrukcji, makroasembler 
zastępuje to wywołanie ciałem makroinstrukcji 

i asembluje otrzymane zdania. 


7.3.6.2. LOCAL - deklaracja symboli wewnętrznych makroinstruk- 
cji 


Postać: 


LOCAL parametr formalny parametr formalny ... 


Dyrektywa ta może występować tylko wewnątrz definicji 
makroinstrukcji i jako pierwsze instrukcje ciała 
makroinstrukcji. 

W czasie asemblacji makroasembler wytwarza określony, 
niepowtarzalny symbol dla każdego parametru formalne- 
go w postaci od ..O001 do ..FFFF., 

Powyższe symbole parametrów formalnych są zwykle 
wykorzystywane jako etykiety wewnątrz makroinstrukcii. 
W ten sposób unika się wielokrotnego definiowania 
etykiet, które może powstać przy kolejnych wywoła- 
niach tej samej makroinstrukcji. 

Użytkownik powinien unikać stosowania własnych 
etykiet o postaci ...nnnn, gdzie n jest dowolną 

cyfrą heksadecymalną, celem wyeliminowania niejedno- 
znaczności. 


7.3.6.3. REPT i ENDM - powtórzenie bloku 
Postać: 


REPT wyrażenie 


ENDM 
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7.3.6.4. 


Dyrektywa ta powoduje powtórzenie bloku instrukcji 
zawartych między REPT a ENDM, tyle razy, ile wynosi 
wartość wyrażenia. 

Wyrażenie to jest określone jako 16-to bitowa liczba 
bez znaku. 

Jeżeli wyrażenie zawiera symbol zewnętrzny lub nie- 
zdefiniowany operand, to sygnalizowany jest błąd. 
Należy zwrócić uwagę, że dyrektywa ENDM, oznaczająca 
koniec bloku zdań podlegającego powtórzeniu, jest 
taka sama, jak dyrektywa oznaczajęca koniec ciągu 
zdań w definicji makroinstrukcji. 


IPR i ENDM - powtórzenie bloku według listy parame- 


trów 
Postać: 
IRP parametr formalny , arglist 
ENDM 


Arglist stanowi listę parametrów /symboli łańcuchów 
znaków, stałych liczbowych lub znakowych/ oddzielo- 
nych przecinkami i ujętych łącznie w nawiasy ostrokęą- 
tne. 


Dyrektywa IPR powoduje powtórzenie bloku instrukcji 
zawartych między IPR i ENDM, tyle razy, ile paramne- 
trów występuje w nawiasie ostrokątnym. 

Przy każdym powtórzeniu w miejscu parametru formalne- 
go jest podstawiany kolejny parametr z listy para- 
metrów. 
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7.3.6.5. 


7.3.6.6. 


IRPC 1 ENDM - powtórzenie bloku według łańcucha 
znaków 


Postać: 


IRPC parametr formalny, łańcuch znaków 


ENDM 


Dyrektywa ta powoduje powtórzenie bloku zdań 
zawartych między IRPC i ENDM, tyle razy, ile znaków 
występuje w łańcuchu znaków. 

Przy każdym powtórzeniu w miejsce parametru formal- 
nego jest podstawiany kolejny znak brany z łańcucha 
znaków. 


EXITM - wyjście z makroinstrukcji 


Postać: 


EXITM 


Dyrektywa ta stosowana jest wewnątrz makroinstrukcji 
lub powtarzanego bloku /dyrektywy REPT, IRP, IRPC/ 
do przerwania rozwijania, gdy wystąpią warunki okre- 
ólające rozwijanie dolne jako niepotrzebne lub nie- 
pożądane. 

Zwykle EXITM jest używana łącznie z dyrektywą warun- 
kowej asemblacji. 

Jeżeli następuje asemblacja EXITM, wówczas przerwa- 
ne jest dalsze rozwijanie. Jeżeli blok zawierający 
EXITM jest zagnieżdżony wewnątrz innego bloku, wów- 
czas rozwijanie bloku wewnętrznego po przerwaniu 
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rozwijania bloku wewnętrznego jest kontynuowane. 


7.3.7. Dyrektywy asemblacji warunkowej 


Dyrektywy asemblacji warunkowej pozwalają wyznaczyć 
wybrane bloki instrukcji programu źródłowego, które 
są albo asemblowane, albo pomijane przy asemblacji, 
w zależności od spełnienia określonych warunków, 
sprawdzanych przez te dyrektywy. 


Warunkowa asemblacja może być zagnieżdżona do 255 
poziomów. 

Argument określający warunek asemblacji powinien 

być zdefiniowany już w pierwszym przebiegu asemblacji 
gdyż w przeciwnym przypadku występuje błędne działa- 
nie i sygnalizowany jest błąd V. 


Dla dyrektyw IF/IFT/COND i IFF/IFE wyrażenia powinny 
być absolutne. 


Każdy blok asemblacji warunkowej może zawierać 
opcjonalną dyrektywę ELSE, wyznaczająca zmienną 
część bloku podlegająca asemblacji, gdy nie jest 
spełniony warunek asemblacji. 


Tylko jedna dyrektywa ELSE może wystąpić dla danego 
bloku asenblacji warunkowej. ELSE jeet powiązane 

z najbliżej położoną dyrektywą badająca warunek asen- 
blacji. 

Wystąpienie większej niż dopuszczalna ilość ELSE 
powoduje sygnalizację błędu C. 
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7.3.7.1. Dyrektywy badające warunek asenblacji 


a/ Postać: 
IF wyrażenie 
IFT wyrażenie 
COND wyrażenie /przy trybie pracy .Z80/ 


Jeśli wartość wyrażenia jest różna od zera, to 
instrukcje wewnątrz bloku asemblacji warunkowej 
są asemblowane. 


b/ Postać: 
IFE wyrażenie 
IFF wyrażenie 


Jeśli wartość wyrażenia jest równa zero, to 
instrukcje wewnątrz bloku asemblacji warunkowej 
są asemblowane. 


c/ Postać: 


IF1 


Jeśli występuje pierwszy przebieg asemblacji, to 
instrukcje wewnątrz bloku asemblacji warunkowej 
są asemblowane. 


d/ Postać: 


IF2 


Jeśli występuje drugi przebieg asemblacji, to 
instrukcje wewnątrz bloku asenblacji warunkowej 
są asemblowane. 
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e/ 


f/ 


g/ 


h/ 


Postać: 
IFOEF _ symbol 


Jeśli symbol jest zdefiniowany lub zadeklarowany 
jako zewnętrzny, to instrukcje wewnątrz bloku 
asemblacji warunkowej są asemblowane. 


Postać: 
IFNDEF symbol 


Jeśli symbol nie jest zdefiniowany lub nie jest 
zadek larowany jako zewnętrzny, to instrukcje 
wewnątrz bloku asemblacji warunkowej są asemblo- 
wane. 


Postać: 
IFB argument 


Wymagany jest zapis nawiasów ostrokątnych razem 

z argumentem. | 

Jeśli nie występuje zapis argumentu /tj. brak 
jest zawartości między ostrokątnymi nawiasami lub 
jakiegokolwiek zapisu poza nazwą dyrektywy/, to 
zdania wewnątrz bloku aseablacji warunkowej są 
asemblowane. 


Postać: 
IFNB argument 


Wymagane jest zapis nawiasów ostrokątnych razem 
z argunenten. 

Jeśli występuje zapis argumentu, to zdania 
wewnątrz bloku asemblacji warunkowej sę 
asemblowane. 
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Dyrektywa stosowana jest dla testowania para- 
metrów formalnych. 


i/ Postać: 
IFIDN argument 1 , argument 2 


Wymagany jest zapis nawiasów ostrokątnych razem 
z argumentami. 

Jeśli łańcuch argument i jest identyczny z łań- 
cuchem argument 2, to zdania wewnątrz bloku 
asemblacji warunkowej są asemblowane. 


j/ Postać: 
IFOIF argument 1 , argument 2 


Wymagany jest zapis nawiasów ostrokątnych razem 
z argumentami. 

Jeśli łańcuch argument 1 różni się od łańcucha 

argument 2, to zdania wewnątrz bloku asenblacji 
warunkowej są asemblowane. 


7.3.7.2. ELSE - określenie zamiennego kodu przy asenblacji 


Postać: 


ELSE 


Pomocnicza dyrektywa stosowana opcjonalnie, wydzie- 
lająca w bloku asenblacji warunkowej tę część bloku, 
która jest asemblowana, jeśli początkowa część ca- 
łego bloku nie jest asemblowana. 

Może być stosowana w połączeniu z dowolną dyrektywą 
badająca warunek asemblacji. 
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7.3.7.3. ENDIF / ENDC - koniec bloku warunkowej asemblacji 


8. 
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Postać: 


ENDIF 


ENDC /przy trybie pracy .Z80/ 


Powyższe dyrektywy wyznaczają koniec bloku warunko- 
wej asemblacji. 

Powinny one wystąpić dla każdej dyrektywy badającej 
warunek asemblacji. 

Dla dyrektywy badającej warunek typu IFxxx, należy 
stosować dyrektywę kończącą ENDIF, 


Dla dyrektywy badającej warunek COND, należy sto- 
sowac dyrektywę kończącą ENDC. 


MAKROASEMBLER - MAC 


Makroasembler - MAC służy do translacji programów napisa- 
nych w języku asemblera INTEL 8080 lub Z80 na przesuwalny 
kod wynikowy. 


Wywołanie programu jest następujące: 
MAC nazwa programu 


gdzie "nazwa programu” określa nazwę pliku kodów 
asemblera o typie /rozszerzeniu/ "ASM". 


Na zakończenie procesu translacji MAC tworzy plik 

"nazwa programu". HEX zawierający kody wynikowe w postaci 
heksadecymalnej, który można załadować i testować progra- 
mami SID ż ZSID /patrz dodatek D/ lub ładować i urucha- 
miać zleceniem LUAD /patrz *CP/J. System operacyjny CP/J - 
dla mikrokomputera ELWRO 800-JUNIOR"/. 
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Dodatkowo zostaje utworzony plik o nazwie "nazwa programu 
.PRN” zawierający listing programu źródłowego wraz z 
komentarzami i wynikiem translacji, oraz plik "nazwa 
programu .SYM* zawierający listę symboli zdefiniowanych 

w programie. 

Postać programu źródłowego, instru! 'je języka oraz następu- 
jące dyrektywy makroasemblera: ORG,--END, EQU,. SET, IF, 
ELSE, ENDIF, DB, OW, DS, PAGE i TITLE, które mogą być sto- 
sowane w programach translowanych przez makroasembler MAC 
opisano w rozdziale 7 tego podręcznika. 


Makroasembler MAC może być wywoływany w sposób opisany 
wyżej bez parametrów lub z parametrami. 
Wywołanie progranu z parametrami jest następujące: 


MAC nazwa programu parametry 
Lista parametrów: 


- określenie dysku źs6dłowego dla pliku .ASM 

- określenie dysku dla pliku .HEX 

- określenie dysku dla pliku .LIB 

kontrola listingu MACRO w pliku .PRN 

- określenie dysku dla pliku .PRN zawierającego listing 
- kontrola listingu symboli LOCAL 


- określenie generacji i dysku dla pliku .SYM 


PR O O v 2 r = » 
ł 


- kontrola listingu i przebiegu. 


W przypadku parametrów A, H, L i S$ następuje po nich nazwa 
dysku, z którego dane są czytane lub, na który mają być 
wyprowadzone przy czym jednostki dyskowe mogą mieć nazwy 
A, ...% y AR 
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Przyjęto konwencję, że urządzenie X odpowiada konsoli 


użytkownika, P jest systemową drukarką /logicznie urzę- 
dzenie listujące LST:/ a Z plik zerowy, który nie jest 
tworzony, na. dysku. 


Po wywołaniu viAC i nazwie pliku źródłowego następuje 


A f 


T „. PB ĄĆ HB SX 


co powoduje zapisanie pliku PRN na dysk B i wczytanie 
pliku ASM z dysku A po czym kieruje plik HEX na dysk B 
i wysyła plik SYM na konsolę użytkownika. 


Jeśli parametry L, S$, M, Q, 1 będą poprzedzone znakiem "+ 


lub "=" otrzymuje się, wówczas następujące modyfikacje 


funkcji: 


listowanie informacji czytanej z makro 
biblioteki 


opuszczenie listingu makro biblioteki 
dodanie pliku .SYM na końcu pliku .PRN 
pominięcie generacji tabeli symboli 


listing wszystkich linii makro przetworzo- 
nych w czasie translacji 


pominięcie wszystkich linii makro przetwo- 
rzonych w czasie translacji 


listing tylko "hex" generowany przez 
rozszerzenie makro 


listing wszystkich symboli LOCAL z listy 
symboli 


pominięcie symboli LOCAL z listy symboli 


utworzenie pliku listingu dla pierwszego 
przebiegu 
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- 1 pominięcie listingu przy pierwszym 
przebiegu 


Przykładowe poniższe parametry translacji: 


WYPB + S-M HB 


powodują zapisanie pliku PRN na dysku B razem 

z listą symboli. 

Wszystkie generacje makro zostaną pominięte, a plik 
HEX zostaje zapisany wraz z plikiem PRN na dysku B. 


Zakładając, że dysk b jest dyskiem bieżącym makro- 
asembler MAC zakłada następujące parametry: pliki 
ASM i LIB zostają przydzielone do dysku b, a pliki 
HEX, PRN i SYM zostają również wysłane na dysk b. 
Tablica symboli generowana jest z pominięciem 
symboli LOCAL i listowane sę linie makro generujące 
kod wynikowy. 


Przykłady: 


Plik przeznaczony do translacji nazywa się "ZADANIE; 
przykładowe wywołanie MAC może mieć postać: 


MAC ZADANIE 4PX + S-M 
które transluje plik ZADANIE .ASM z listowaniem na 


konsoli, ale bez listingu generowanych makroinstruk- 
cji. 
MAC A : ZADANIE 4+S5 - m + q 


transluje plik ZADANIE .ASM z dysku A, tworzy 
ZADANIE .PRN na dysku bieżącym, pomijając generowa- 
nie makro oraz oprócz normalnie listowanych symboli 
listuje symbole rozpoczynające się od znaku *??" 
/etykiety typu LOCAL/. 
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MAC ZADANIE 


transluje plik ZADANIE .ASM z dysku bieżącego, 
tworzy plik ZADANIE .PRN, ZADANIE .„SYM i plik 
ZADANIE .HEX na tym samym dysku. 

Można dodatkowo stosować poniższe funkcje kontrolne 
umieszczone w tekście programu i umieszczone na 
początku dowolnej linii tekstu programu: 


U - PRINT zatrzymanie generowania 
listingu 

U - PRINT umożliwienie poprzednio wstrzyma- 
nego drukowania listingu 

+7 - MACRO pominięcie generowania makro 
"linii w listingu 

X - MACRO wprowadzenie wszystkich form 
makro 

g£ f MACRO wprowadzenie części form makro 


/jak w "*W'/. 
Ponieważ makroasembler MAC umożliwia wprowadzenie 


numeru każdej linii, znak kontrolny "CC "  powi- 
nien być umieszczony zaraz po numerze linii. 
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ZAŁĄCZNIK A 


ZESTAWIENIE DYREKTYW MAKROASEMBLERA M80 


W zestawieniu dyrektywy, odpowiedające dotychczas używanym 
dla mikroprocesora Z80, oznaczono gwiazdką /«/, a stosowane 
dla mikroprocesora 8080 pozostawiono bez gwiazdki. 
Makroasembler MAKREL akceptuje /jeśli nie podano inaczej/ 
wszystkie dyrektywy dla obu typów mikroprocesora. 


Dyrektywy wyboru zestawu instrukcji 
.Z80 
„8080 


Dyrektywy definiowania danych i symboli 


nazwa ASET wyrażenie 

BYTE EXT symbol 

BYTE EXTRN symbol 

BYTE EXTERNAL  synbol 

DB wyrażenie wyrażenie ... 


OB łańcuch łańcuch ... 


DC łańcuch 

DDB wyrażenie wyrażenie ... 
DEFB wyrażenie wyrażenie ... 
nazwa DEFL wyrażenie 

DOEFM łańcuch łańcuch ... 


DEFS wyrażenie wartość ... 


7110.5022—01 33—0 61 


DEFW wyrażenie wyrażenie ... 
DS wyrażenie wartość 

DW wyrażenie wyrażenie ... 
ENTRY nazwa nazwa ... 

nazwa EQU wyrażenie 

EXT nazwa nazwa ... 

EXTRN nazwa nazwa ... 
EXTERNAL nazwa nazwa ... 
GLOBAL nazwa nazwa ... 
PUBLIC nazwa nazwa ... 


nazwa SET wyrażenie  /nie używana w trybie pracy 
.Zz80/ 


Dyrektywy trybu asemblacji 


ASEG 

CSEG 

DSEG 

COMMON nazwa bloku 
ORG wyrażenie 
„PHASE wyrażenie 
„DEPHASE 
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Dyrektywy dotyczące pliku z programem źródłowym 


„COMMENT ogranicznik tekst ogranicznik 
END wyrażenie 

INCLUDE nazwa pliku 

ZINCLUDE nazwa pliku 

MACLIB nazwa pliku 

NAME / nazwa modułu 

„RADIX wyrażenie 


„REQUEST nazwa pliku, nazwa pliku ... 


Dyrektywy sterujące dla listingu 
sterowanie formatem 


EJECT wyrażenie /gwiazdka w nazwie dyrektywy/ 
PAGE wyrażenie 

SUBTTL tekst 

TITLE tekst 

STITLE tekst 


dyrektywy ogólnego przeznaczenia 


„LIST 
„XALIST 


„PRINTX ogranicznik tekst ogranicznik 
sterowanie wydrukiem warunkowej asemblacji 


„SFCOND 
„ LFCOND 
„TFCOND 
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sterowanie wydrukiem dla rozwinięć 


.XKALL 


sterowanie wydrukiem odwołań 


„XCREF 


„CREF 


Dyrektywy dla makroinstrukcji i powtórzeń bloku 
dla makroinstrukcji 


nazwa MACRO parametr parametr ... 
ENDM 
EXITM 


LOCAL parametr parametr ... 


dla powtórzeń 
REPT wyrażenie 
IRP parametr formalny parametr w nawiasach ostrokąt. 


IRPC parametr formalny łańcuch 
Dyrektywy asemblacji warunkowej 


COND wyrażenie 
ELSE 

ENDC 

ENDIF 

IF wyrażenie 
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IFB argument 
IFOEF symbol 
IFDIF agrument 1 
IFE wyrażenie 
IFF wyrażenie 
IFIDN argument 1 
IFNB argument 
IFNDEF symbol 
IFT wyrażenie 
IFi 

IF2 
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argument Z 


argument 2 
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ZAŁĄCZNIK B 


ZESTAWY INSTRUKCJI DLA MIKROPROCESORÓW Z80 


Instrukcje dla Z80 


Kod operacji 


CALL adres 

CALL war, adres 
CCF 

CP 

CPD 

CPOR 

CPI 

CPIR 

CPL 

DAA 


DEC 
DI 
DJINZ 


I 8080 


Funckja 


Dodanie z przeniesieniem do akumula- 
tora 

Dodanie pary rejestrów z przeniesie- 
niem do HL 

Dodanie 

Iloczyn logiczny 

Testuj 

Wywołanie podprogramu 

Wywołanie warunkowe 

Zmiana wskaźnika przeniesienia 
Porównanie 

Porównanie i zmniejszenie 
Porównanie, zmniejszenie i powtórzenie 
Porównanie i zwiększenie 
Porównanie, zwiększenie i powtórzenie 
Dopełnienie akumulatora 
Przystosowanie akumulatora do liczb 
dziesiętnych 

Zmniejszenie 

Zakaz przerwań 

Zmniejszenie i skok, jeśli nie zero 
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INOR 

INI 

INIR 

JP adres 

IP war, adres 

JR 

JR war, adres 

LD A, /adres/ 

LD A, /BC/ lub /DE/ 
LD A, I 


LD AR 
LD HL, /adres/ 
LD dane 


LD xy, /adres/ 


LOD rejestr /HL/ 


LD rejestr /xy+disp/ 


LD rp, /adres/ 
LOD SP, HL 
LD SP, xy 


LD przeznaczenie, 


źródło 
LD /adres/, A 
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Umożliwienie przerwań 

Wymiana 

Wymiana par rejestrów i alternatywy 
Stop 

Ustalenie trybu przerwań 

Wejście 

Zwiększenie 

Wejście i zmniejszenie 

Wejście, zmniejszenie i powtórzenie 
Wejście i zwiększenie 

Wejście, zwiększenie i powtórzenie 
Skok 

Skok warunkowy 

Skok względny 

Skok względny, warunkowy 
Ładowanie akumulatora 

Ładowanie akumulatora pośrednie 
Ładowanie akumulatora z rejestru 
wektora przerwania 

Ładowanie akumulatora z rejestru 
odświeżania 

Ładowanie bezpośrednie HL 
Ładowanie natychmiastowe 
Ładowanie bezpośrednie rejestru 
indeksu 

Ładowanie rejestru 

Ładowanie rejestru z indeksowaniem 
Ładowanie pary rejestrów 
Przesłanie HL do wskaźnika stron 
Przesłanie rejestru indeksu do 
wskaźnika stron 

Przesłanie rejestr - rejestr 


Zapamiętanie akumulatora 
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LD /BC/ lub /DE/, A 


LD I, A 


LD /HL/, dane 


LD /adres/, HL 
LD /xy+disp/, dane 


LOD /adres/, xy 


LD /HL/, rejestr 
LD /xy+disp/, rejestr 


LOD /adres/, rp 
LDD 
LODR 


LDI 
LDIR 


NEG 
NOP 
OR 
OUT 
OUTD 
OTDR 


OUTI 
OTIR 
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zapamiętanie akumulatora 
pośrednie 

Zapamiętanie akumulatora w re- 
jestrze wektora przerwania 
Zapamiętanie akumulatora w re- 
jestrze odświeżania 
Zapamiętanie natychmiastowe w 
panięci 

Zapamiętanie bezpośrednie HL 
Zapamiętanie natychmiastowe w 
pamięci z indeksowaniem 
Zapamiętanie bezpośrednie reje- 
stru indeksu 

zapamiętanie rejestru 
Zapamiętanie rejestru z indekso- 
waniem 

Zapamiętanie pary rejestrów 
załadowanie i zmniejszenie 
Załadowanie, zmniejszenie 

i powtórzenie 

Załadowanie i zwiększenie 
Załadowanie, zwiększenie i powtó- 
rzenie 

Zaszeregowanie akumulatora 

Nic nie rób 

Suma logiczna 

Wyjście 

Wyjście i zmniejszenie 
Wyjście, zmniejszenie i powtó- 
rzenie 

Wyjście i zwiększenie 

Wyjście, zwiększenie i powtó- 
rzenie 
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POP 
PUSH 
RES 

RET 

RET war 
RETI 
RETN 

RL 


RLA 


RIC 
RICA 


RLD 


RR 


RRA 


RRC 
RRCA 


RRD 


RST 
SET 
SBC 
SCF 
SLA 
SRA 
SRL 


SUB 
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Pobranie ze stosu 

Umieszczenie na stosie 

Zerowanie bitu 

Powrót z podprogramu 

Powrót warunkowy 

Powrót z przerwania 

Powrót z niemaskowanego przerwania 
Przesunięcie z przeniesieniem w 
lewo 

Przesunięcie akumulatora z prze- 
niesieniem w lewo 

Przesunięcie cykliczne e lewo 
Przesunięcie akumulatora cyklicznie 
w lewo 

Przesunięcie akumulatora i pamięci 
dziesiętnie w lewo 

Przesunięcie z przeniesieniem w 
prawo 

Przesunięcie akumulatora z przenie- 
sieniem w prawo 

Przesunięcie cykliczne w prawo 
Przesunięcie akumulatora cyklicznie 
w prawo 

Przesunięcie akumulatora i pamięci 
dziesiętnie w prawo 

Restart 

Ustawienie bitu 

Odejmowanie z pobraniem 

Ustawienie przeniesienia 
Przesunięcie arytmetyczne w lewo 
Przesunięcie arytmetyczne w prawo 
Przesunięcie logiczne w prawo 


Odejmowanie 
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XOR Logiczna różnica symetryczna 


Instrukcje dla 8080 


Kod operacji Funkcja 

ADC, ACI Dodanie z przeniesieniem 

ADD, ADI Dodanie 

ANA, ANI Iloczyn logiczny 

CALL Wywołanie podprogramu 

je, Wywołanie, jeżeli przeniesienie 

CM Wywołanie, jeżeli minus 

CMA Dopełnienie akumulatora 

CMC Dopełnienie przeniesienia 

CMP, CPI Prównanie 

CNC Wywołanie, jeżeli brak przeniesienia 

CNZ Wywołanie, jeżeli nie zero 

CP Wywołanie, jóżeli plus 

CPE Wywołanie, jeżeli parzystość 

GPO Wywołanie, jeżeli nieparzystość 

cz Wywołanie, jeżeli zero 

DAA Przystosowanie akumulatora do 
liczb dziesiętnych 

DAD Dodawanie 16-to bitowe 

DCR Zmniejszenie 

DCX Zmniejszenie dla 16-tu bitów 

DI Zakaz przerwań 

EI Umożliwienie przerwań 

HLT Stop 

IN Wejście 

INR Zwiększenie 
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Zwiększenie dla 16-tu bitów 
Skok, jeżeli przeniesienie 
Skok, jeżeli minus 

Skok 

Skok, jeżeli brak przeniesienia 
Skok, jeżeli nie zero 

Skok, jeżeli plus 

Skok, jeżeli parzystość 

Skok, jeżeli nieparzystość 
Skok, jeżeli zero 

Ładowanie akumulatora 

Ładowanie akumulatora pośrednie 
Ładowanie bezpośrednie HL 
Ładowanie 16-to bitowe 
Przesłanie 

Przesłanie natychmiastowe 

Nic nie rób 

Suma logiczna 

Wyjście 

HL do licznika rozkazów 
Pobranie ze stosu 

Umieszczenie na stosie 
Przesunięcie z przeniesieniem w 
lewo 

Przesunięcie z przeniesieniem w 
prawo 

Powrót, jeżeli przeniesienie 
Powtór z podprogramu 
Przesunięcie w lewo 

Powrót, jeżeli minus 

Powrót, jeżeli brak przeniesienia 
Powrót, jeżeli nie zero 

Powrót, jeżeli plus 


Powrót, jeżeli parzystość 


11 


RPO 

RRC 

RST 

RZ 

SBB, SBI 
SHLD 
SPHL 
STA 
STAX 

STC 

SUB, SUI 
XCHG 
XRA, XRI 
XTHL 
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Powrót, jeżeli nieparzystość 
Przesunięcie w prawo 

Restart 

Powrót, jeżeli zero 
Odejmowanie z pobraniem 
Zapamiętanie bezpośrednio HL 
HL do wskaźnika stosu 
Zapamiętanie akumulatora 
Zapamiętanie akumulatora pośrednio 
Ustawienie przeniesienia 
Odjęcie 

Zamiana OE i HL 

Logiczna różnica symetryczna 
Zamiana szczytu stanu z HL 
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ZNŁACZNIK C 


PROGRAM ŁĄCZĄCY - L80 


Załącznik C zawiera opis 1 sposób uruchomienia programu L80. 


Program przeznaczony jest dla użytkowników i programistów 
pracujących na mikrokomputerze ELWRO 800-JUNIOR wyposażonym 
w system operacyjny CP/J. 


Służy do ładowania i łączenia programów typu REL w plik 
zawierający program wynikowy. 


1. Uruchomienie programu L80 


Do uruchomienia programu L80 służy komenda: 
LB8O 
po której zostaje wyprowadzony znak " >» " wskazujący 
gotowość do przyjmowania komend. 
2. Komendy programu L80 
Komendy programu L80 mogą być w postaci: 


- nazw plików oddzielonych przecinkami 
- dyrektyw 


Komendy można wprowadzać pojedyńczo / po znaku "« "/ lub 


wszystkie w jednej linii /łącznie z L80/. 


Przykład i 
L8O (GR) 
y nazwa pliku, nazwa pliku (CR) 
x /dyrektywa 
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Przykład 2 


L8O nazwa pliku, nazwa pliku /dyrektywa ... (CR) 


Wywoływanie pojedyńczych zleceń jest wolniejsze w dzia- 
łaniu, ale pozwala użytkownikowi śledzić kolejność wyko- 


nywanych czynności. 


2.1. 


Nazwa pliku jako zlecenie jest określeniem pliku zgod- 
nym ze standardem stosowanym w systamie operacyjnym CP/J. 


Dyrektywy 


W łańcuchu komend programu L80 można podać szereg dy- 
rektyw służących do określenia działań wpływających na 
ładowanie lub łączenie programu. 

Każda dyrektywa musi być poprzedzona znakiem "/". 

W linii zlecenia można zapisać dowolną ilość dyrektyw. 
Umieszczenie dyrektywy na początku w łarcuchu zlecenia 
odnosi się do programów już załadowanych do pamięci. 
Umieszczenie dyrektywy bezpośrednio za nazwą pliku 
powoduje działanie dyrektywy tylko dla tego pliku. 
Dyrektywy umieszczone na końcu łańcucha komend wpływają 
na cały proces ładowania i łęczenia plików /programów/. 


2.2.1. Opis dyrektyw 
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/N 


Dyrektywa powoduje zapisanie połączonego programu 
do pliku wynikowego. 

Dyrektywa ta musi występować bezpośrednio po nazwie 
pliku do którego będzie zapisany program wynikowy. 
Jeżeli nie poda się typu pliku wynikowego to domyś- 
lnym typem jest COM. 
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Należy zawsze podać przynajmniej jeden plik wynikowy. 


/E 
Dyrektywa ta powoduje załadowanie do pamięci progranu, 
którego nazwa została określona w linii zlecenia, 
wykonanie łączenia i powrót do systemu operacyjnego 
CP/J. 
Po zakończeniu działania L80 wyprowadza informację 
o zajętości pamięci /patrz dyrektywa /G /. 


Przykład: 
L80 ZBi, ZB1.COM /N/E 
gdzie: 
ZBi - nazwa pliku wejściowego z rozszerzeniem REL 
ZB1.COM = nazwa i rozszerzenie pliku wynikowego 


L8O0 ZB1.COM/N, ZB81, ZB2, ZB3/E 


ZB1.COM - nazwa pliku wynikowego 
ZB1, ZB2, ZBZ - nazwy plików wejściowych /z rozsze- 
rzeniem REL/ 


Aby uruchomić zachowany na dysku progran wynikowy, 
należy podać, na poziomie zleceń nierezydentnych 
systemu nazwę programu. 


/G 


Dyrektywa ta powoduje załadowanie do pamięci programu 
określonego w linii zlecenia , wykonanie łączenia 

i uruchomienie utworzonego programu wynikowego. 

Po zakończeniu wykonania programu następuje powrót 
do systemu operacyjnego CP/J. 
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Przykład: 
L8O JX, JX/N/G 


Po połączeniu pliku JX.REL i utworzeniu pliku 
JX.COM nastąpi uruchomienie i wykonanie progranu 
JX.COM oraz powrót do systemu operacyjnego CP/J. 


Przed uruchomieniem programu użytkowego , L80 wypro- 
wadza informację określającą adres początkowy pro- 
gramu, adres ostatniego bajtu programu /adres końco- 
wy/, ilość stron /256-bajtowych/ zajętych przez 
program od adresu 100H do adresu końca programu. 


Przykład: 


/4010 41Fi 65/ 
gdzie: 


4010 - adres początkowy programu 
41F1 - adres końcowy programu 


65 - ilość stron 


UWAGI : 


Dyrektywa /N nie działa, jeżeli nie wystąpi 

po niej dyrektywa /E lub /G. Należy ją stosować 
zawsze gdy musi być zachowany program wynikowy. 
Użycie dyrektyw /N/E lub /N/G jest wymagane w 
większości operacji realizowanych przez program 
L80. Dyrektywy /N/E powodują łączenie plików 
/programów/ w jeden plik /program/ wynikowy, 
uruchomienie utworzonego programu wynikowego 

i powrót do systemu operacyjnego CP/J. 

Jeżeli używa się dyrektywy /G program zostaje 
automatycznie uruchomiony bez względu na roz- 
szerzenie nazwy programu wynikowego. 
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/P: adres 


Dyrektywa służy do ustawienia adresu początkowego 
programu i danych. 

Wartość adresu musi być wyrażona w aktualnym syoto- 
mie liczenis, /domyślnie przyjmowany jest system 
szesnastkowy/. 

Jeżeli nie poda się parametru adres „ to przyj- 
mowany jest adres 103H. 

Dyrektywa /P pozwala umieścić segmenty programu pod 
różne adresy. Należy ją umieścić przed nazwą pliku, 
który ma być ładowany począwszy od określonego 
adresu np.: 


LBO /P:103,IX,IX/N/E 


W czasie jednego przebiegu łączenia można użyć 

kilku dyrektyw /P do umieszczenia różnych segmentów 
pod różnymi adresami. Należy jednak zwrócić uwagę, 
aby obszary segmentów nie nakładały się, obszary 
programu nie mogą przeplatać się z obszarami danych 
i COMMON. 

W segmencie z programem mogą być przerwy między 
modułami, ale segment ten nie może zawierać danych 

i odwrotnie. 


Program L80 nie wypełnia przerw spacjami. 


/D: <adres> 


Dyrektywa działa tak samo jak dyrektywa /P /dla 
obszarów danych i  COMMON/. 

Użycie dyrektyw /P i /D powoduje, że obszary danych 
i COMMON będą załadowane pod adres określony w /D, 

a początek obszaru programu zostanie określony przez 
adres podany w /P. 
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/R 


Dyrektywa ta powoduje powrót programu L80 do poziomu 
zleceń operatora. 

Po napotkaniu tej dyrektywy program L80 przerywa 
obsługę ostatniej linii zlecenia, ignoruje pliki, 


wyprowadza na monitor ekranowy znak * i oczekuje 


na wprowadzenie nowego zlecenia. 


/U 


Dyrektywa powoduje wylistowanie wszystkich niezde- 
finiowanych symboli globalnych. 
Działa tylko wtedy, gdy w linii zlecenia nie występu- 


ję dyrektywy /G i /E. 
Listowanie symboli można przerwać używając CTRL-=S 
oraz wznowić przez CTRL-Q. 


/M 


Dyrektywa powoduje wyprowadzenie na monitor zdefinio- 
wanych oraz niezdefiniowanych symboli globalnych. 


/Q 


Dyrektywa zmienia system liczenia na ósemkowy. 


/H 


Dyrektywa zmisnia system .iczenia na szesnastkowy, 
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/X 


Uyrektywa ta powoduje utworzenie pliku wynikowego 

w szesnastkowym kodzie ASCII. 

Dyrektywa musi być połączona z dyrektywą /N i /E. 

Plik zachowany przy pomocy dyrektyw /X, /N i /E 
otrzymuje rozszerzenie HEX. 

Dyrektywa /X stosowana jest głównie w celu przygotowa- 
nia programów do zapisu w pamięci ROM. 


/ 


Dyrektywa powoduje utworzenie dodatkowo pliku wyniko- 
wego w specjalnym formacie typu SYM. 

Plik SYM zawiera nazwy i adresy wszystkich symboli 
globalnych. Pozwala to na użycie programów SID i ZSID. 


Komunikaty o błędach 


Błędy powstałe podczas uruchomienia programu L80 sygnalizowa- 
ne są przez odpowiednie komunikaty a nie kod błędu. 


Większość komunikatów zaczyna się symbolem "?" lub "5". 
? Brak adresu startu - została wydana dyrektywa /G lecz 


nie został załadowany żaden program 
główny 


? Błąd odczytu - ostatni plik opisany jako wyjściowy 
jest źle sformatowany lub brak odpo- 
wiedniej ilości nazw plików 


? Brak pamięci - brak dostatecznej ilości pamięci do 
załadowania programu 
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? Błędna komenda 


? nazwa pliku brak 


? Etykiety startu - nie- 
znane - brak def. 


Drugi COMIMON większy 
XXXXXX 


Wielokrotnie zdefiniowana 
zmienna globalna yyyyyy 


Nałożenie obszaru danych 


lub 
Nałożenie obszaru kodu 


została wydana nieprawidłowa 
komenda programu ELINK 


plik o nazwie nazwa pliku nie 
został znaleziony na dysku 


po podaniu dyrektywy /E lub /G 
niezdefiniowany by- symbol 
adresu startowego 


brak miejsca do alokacji segmentu 
wspólnego COMMON tzn. że segment 
wspólny o nazwie xxxxxx w pierw- 
szym z modułów nie był najwięk- 
szym blokiem. Należy zmienić 
kolejność ładowania modułów lub 
zmienić definicję bloku COMMON 
tak, aby wszystkie bloki miały tę 
samą wielkość 


jeden symbol globalny o nazwie 
yyyyyy posiada więcej niż jedną 
definicję 


start z xxxX 
Public = nazwa symbolu xxXxX 
External s nazwa symbolu xxxx 


start a xxxx 
Public = nazwa symbolu xXXX 
External = nazwa symbolu xxxx 


adresy ustalone przez dyrektywy 
/P lub /D są zbyt blisko siebie 
albo zachodzą na siebie. 

W wyniku tego dane albo program 
mogą nałożyć się na siebie 
/poprzednio załadowane moduły 
mogą się zniszczyć/. 
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Ingerencja obszaru danych 


lub 
Ingerencja obszaru kodu - przecinanie się obszarów da- 
nych i programu 


Lokacja powyżej dostępnej pamięci - zmienić T/N ? 


? źródło poniżej , zreorganizować 

pamięć /Y lub N/? - komunikat pojawia się podczas 
wykonywania dyrektywy /E lub 
/G, kiedy adres ładowania był 
poniżej lub powyżej obszaru 
pamięci dostępnego dla pro- 
gramu L80  « 
Odpowiedź na komunikat ze 
znakiem * powoduje automaty- 
czne przemieszczenie segmen- 
tów, odpowiedź N powoduje 
zakończenie działania progra- 


mu L80 

? Błąd zapisu pliku COM - błąd na dysku podczas wykony- 
wania operacji zapisu pliku 
wynikowego 

lub 

? Błąd zapisu pliku 

Brak pliku - brak podanego zbioru wejścio- 
wego na dysku 

Słąd odczytu - błąd czytania zbioru wejścio- 
wego 


Dysketka pełna 


Start programu 
Wolny obszar 
? Etykiety startu 
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ZAŁĄCZNIK D 


DEBUGGER'Y SYMBOLICZNE SID i ZSID 


Dodatek ten zawiera opis debugger'ów symbolicznych SID i ZSID. 
Debugger SID stosowany jest do testowania i uruchamiania 
programów napisanych w j.asemblera procesora INTEL, ZSID w j. 
asemblera procesora Z8O. 


Ponieważ opisy powyższych debugger'ów są takie same, w do- 
datku opisano debugger używając symbolu "SID", który ozna- 
cza zarówno symbol "SID" i "ZSID". 


1. Sposoby uruchomienia programu 


SID - załadowanie SID bez ładowania programu 
SID X,Y - załadowanie SID i programu X, Y 


SID X,YU.V - załadowanie SID, programu X, Y i tabeli 
symboli U.V 


SID U.V - załadowanie SID i tabeli symboli 


Program SID po załadowaniu zgłasza się znakiem 4. 


2. Dyrektywy 


2.1. Znaki specjalne 


CTRL - C - Powrót do systemu operacyjnego CP/J 
CTRL - E - Koniec linii 
CTRL - P - Włączenie wyłączenie drukarki 
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CTRL - R - przepisanie bieżącej linii 
CTRL - S - zatrzymanie/wznowienie wydruku na 
konsoli 
CTRL - U - likwidacja linii 
CTRL = H - likwidacja znaku i cofanie kursora 
BS - likwidacja znaku 


W każdej chwili wydruk na konsolę/Np. DYREKTYWA 0/ 
może być przerwany przez wciśnięcie dowolnego klawisza. 


2.2. Wyrażenia symboliczne 
Wszystkie parametry dyrektywy mogą być w postaci wyra- 
żenia. 


Wyrażeniem jest dowolny ciąg elementów połączony opera- 
torami dodawania + lub odjenowania - . 


Elementami są: 
- liczby heksadscymnalne 


1 lub więcej cyfr heksadecymalnych - rozpatrywane 
są tylko 4 ostatnie 
np. 
i 
38001 - rozpatrywane 8001 
- liczba dziesiętna 


jeden lub więcej cyfr dziesiętnych rozpoczynaję- 


cych się znakiem . 
np. 4 1 
jł 256 
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- znaki ASCII 


1 lub więcej znaków umieszczonych między apostro- 
fami /jeśli znakiem jest apostrof to należy go 
napisać jako dwa apostrofy/. 


Rozpatrywane są kody dwóch ostatnich znaków. 


np. 
"A" s 0041 
"AB" s 4142 
80.00 2 = 0060 
- symbole 
Formaty: 
.S - bezpośrednia wartość symbolu S 
ę8 - zawartość dwóch sąsiednich bajtów 
/wartość 16-bitowa/ wskazywanych 
przez symbol S. 
z$ - zawartość bajtu wskazywanego przez 34 
np. 


Wartość symbolu GAMMA = 100 


Zawartość komórek 
100 s 02 
101 s 3E 


Wartość elementów wyrażenia 


„GAMMA = 0100 
9 GAMMA = 3E02 
=GAMMA = 0002 
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2.3. Opis dyrektyw 


W programach SID i ZSID mogę być używane następujące 


dyrektywy: 


A 


C 


D 


L 0 "mn 


X CC 4 O 8 U Z TT H 


Asemblacja 
Wywołanie podprogramu 


Wyprowadzenie zawartości pamięci w formacie 
HEX i ASCII 


Wypełnienie pola pamięci stałą wartością 
Uruchomienie testowanego programu 
Obliczanie wartości heksadecymalnej 


Wprowadzenie wiersza 


Listowanie instrukcji w postaci mnemonicznej 


Przesunięcie bloku pamięci 

Ustawienie stałej pułapki 

Wczytanie programu lub tablicy symboli 
Ustawienie adresu pamięci 

Wykonanie ciągu instrukcji ze śledzeniem 
Wykonanie ciągu instrukcji bez śledzenia 


Wyprowadzenie stanu procesora 


2.4. Opis zastosowania dyrektyw 


Dyrektywa wprowadzania instrukcji 


AS 
-A 
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- usunięcie z pamięci modułu asembler/deaseanbler 


- rozpoczęcie wprowadzania instrukcji od adresu S$ 
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UWAGA: Po zastosowaniu tej dyrektywy nie może być używana 
dyrektywa A, a dyrektywy L i T powodują wypisanie 
jedynie kodu instrukcji w postaci HEX. 


S - początkowy adres wprowadzania, jeśli nie 
podany, to przyjmowany jest adres ostatnio 
ustawiony przez dyrektywy L, T lubu. 


W instrukcjach można używać wyrażeń w dowolnej 
dozwolonej postaci. 
Zakończenie wprowadzania po wciśnięctu znaku 


/CR/. 
NP+ 9100 MVI C,A - .B 
0102 LXI H,.SOURCE 
0105 LXI 0,+100  ; argument jest 
równy „SOURCE 
+100 
0108 (CR) ; znak kończący 


asemblację 


Dyrektywa wywołania progranu 
CS, B, D - wywołanie podprogramu od adresu S$ 


gdzie: 


S - adres startu podprogramu; podprogram musi 
kończyć się rozkazem RET 


B  - wartość wpisywana do pary rejestrów BC; jeśli 
nie jest podana, to wpisywane jest f. 


D - wartość wpisywana do pary rejestrów DE, jeśli 
nie jest podana to wpisywane jest f. 
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np. 


C.INITPRG, <ALFA, 412 


Dyrektywy wyprowadzania zawartości pamięci 


DS ,F - wyprowadzenie zawartości pamięci w postaci 
baj towej 


DOWS,F - jak wyżej w postaci słowowej 


gdzie: 


S - adres pierwszej wyprowadzanej komórki; gdy nie 
podana to przyjmowany jest adres ostatnio wyświe- 
tlony lub zawartość rejestrów HL, jeśli od czasu 
wejścia w ostatnią pułapkę nie wyświetlono zawar- 
tości pamięci. 


F - końcowy adres wyprowadzania; jeśli nie podany, 
to wyprowadzanych jest 12 wierszy. 


Dyrektywa w pierwszej postaci wyświetla bajty pamięci 
w następującym formacie: 


AAAA BB BB BB ,,. BB CCCC ... 


gdzie: 


AAAA - adres pierwszego wyprowadzonego bajtu w wierszu 


BB BB... - cięg /do 16 w wierszu/ dwucyfrowych liczb 
heksadecymalnych określający zawartość 
kolejnych bajtów. Pierwszy wyświetlany 
wiersz zawiera tyle liczb, aby początkowe 
adresy wyświetlania w następnych liniach 
były podzielne przez 16. 
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CCCC ...  - Zawartość wyprowadzanych w wierszu bajtów 
przedstawiona w postaci znaków ASCII 
/do 16 znaków/. 


Dyrektywa w drugiej postaci wyprowadza kolejne słowa 
/2 bajty/ pamięci w formacie: 

AABA wwww wwww WwWwWwwWw ... WWww CCCC ... CC 
AAAA, CCC ..,. - jak w pierwszej postaci 

wwww - czterocyfrowe liczby HEX 


Dyrektywa wpisywania do pamięci 


FS, FD  - wpisuje do pamięci od adresu S do F /włącznie/ 
stałą wartość określoną przez D 


Dyrektywy uruchomienia programu 


GP, A, B 


uruchomienie programu od adresu P 


-GP, A,B  - jak wyżej; dyrektywa w drugiej postaci 
wypisuje kolejne słowa /2 bajty/ pamięci 
w formacie: 


AAAA - przebieg nie osiągnie wartości i 


P - adres startu; gdy nie podany to start od 
bieżącej wartości PC, 


A,B - adresy pułapek dynamicznych, po wejściu 
w którakolwiek, wszystkie są likwidowane; 
gdy nie podane to pułapki nie są ustawiane. 
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Po wejściu w pułapkę jest wyświetlane: 
3+A S$ 


A - adres pułapki 


S - symbol / o ile istnieje/ związany z tym 
adresem. 

np. 
G100 


G.CRLF, „PRINT, ff 1024 


Dyrektywa obliczania i różnicy wyrażeń 


HA, B - obliczenie i wyświetlenie /heksadecymal- 
nie/ sumy i różnicy wyrażeń A i B, 


HA - wyświetlenie wartości wyrażenia A w 
czterech postaciach heksadecymalnej, 
dziesiętnej, znakowej jako symbol 
/jećli istnieje/ 


H - wyświetla całą listę symboli wraz z ich 
wartościami 

np. 

HO, 1 

H 'A' + s GAMMA 

0042 H 66 'B' 


Dyrektywa wprowadzania wiersza 


I CCCCCC ... Symulacja wprowadzania wiersza do 
programu 
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CCCC ... Dowolny eiąg znaków 


np. 


Jeśli program uruchamiany DUMP ma być później 
wywołany 


DUMP X.COM 


to w czasie testowania w celu wprowadzenia nazwy 
pliku X.COM należy wprowadzić: 


IX .COM 
Jeśli jako ciąg CCCC ... podane są nazwy 1 lub 2 
plików, to są rezerwowane i inicjowane jeden lub 


dwa bloki opisu pliku FCB1 i FCB2 pod adresami 
odpowiednio 005C /FCBi/ i O06C /FCB2/. 


/Uwaga: ponieważ pole FCB2 pokrywa częściowo pole 
FCB1, należy je przed użyciem przepisać w inny 
obszar/. 


Dodatkowo linia CCCC ... jest wpisywana do bufora 
DBUFF /ADR .80-FF/ 


np. 
I B: ALFA, ASM BETA .LIB 


Dyrektywa J jest także używana w połączeniu z dyrek- 
tywą R w celu specyfikacji pliku. 


Dyrektywa listowania pamięci 


LS,E - listowanie w postaci mnemonicznej od 
adresu S$ do F z użyciem symboli 

- L S$, F - jak wyżej tylko bez symboli 

gdzie: 


S - adres pierwszej listowanej instrukcji; jeśli nie 
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podany to przyjmowany jest adres ostatnio listo- 
wany, translowany /Dyr. A/ śledzony lub ostatni 
adres pułapki /G,P/. 


F - końcowy adres listowania; gdy nie podany to 
wyświetlane 12 wierszy 


Format listowania: 


SSSSSS: 
AAAA OPCODE OPERAND „TTTTTT 


gdzie: 

SSSSSS - symbol o wartości adresu AAAA /jeśli istnie- 
je/ 

AAAA - adres instrukcji 

OPCODE - kod instrukcji 


OPERAND - argumenty instrukcji 


TTTTTT - symbol /jeśli istnisje/ związany z argu- 
mentenm. 


Przy instrukcjach odwołujących się do pamięci jak np. 
INR M jest wypisywana wartość wskazywana przez argument 
OPCODE M a HH 


Dyrektywa ustawiania pułapki 


PP, C - ustawienie pułapki pod adresem P z liczni- 
„kiem C 

P - wyświetlenie wszystkich pułapek 

-PP - likwidacja pułapki spod adresu P 
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- P  - likwidacja wszystkich pułapek 
Pp - adres pułapki 


c - początkowa wartość licznika pułapki; gdy 


nie podano to ustawione 1. 


W jednym czasie może istnieć do 8 pułapek. 


Każde wejście w pułapkę zmniejsza licznik o 1, jeśli 
nie jest on już równy 1. 

Gdy równa się 1 to wykonywanie programu jest przerywa- 
ne, po wykonaniu instrukcji gdzie ustawiana jest pu- 
łapka. Wejście w pułapkę nie likwiduje jej. 


Każde wejście w pułapkę powoduje wyprowadzenie: 
CC PASS PPPP .„SSSS 


CC - licznik pułapki 
PPPP - adres pułapki 


SSSS = symbol związany z tym adresem 


Dyrektywa wczytania progranu lub tabeli symboli 


R - wczytanie testowanego programu lub tablicy 
symboli z pliku wyspecyfikowanego w dyrekty- 
wie J, 


RD  - jak wyżej, tylko dodaje wartość D do adresu 
ładowania 
np. 
JDUMP „COM DUMP „SYM 
R 
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Dyrektywa ustawiania adresu pamięci 


SS - ustawienie bajtów począwszy od adresu S$ 


SWS - ustawienie słów /dwóch bajtów/ począwszy od 
adresu S$. 


Dyrektywa powoduje wyprowadzenie wartości z pod adresu 
S, następnie oczekuje na wprewadzenie nowej wartości. 
Nowa wartość może byc podana w postaci wyrażenia lub 
dla S /wyświetlenie bajtów/ można wprowadzić ciąg 
znaków: 


CCCCCC .... 


Nowa wartość jest kończona znakiem /CR/. 
Wprowadzenie samego znaku /CR/ nie zmienia zawartości 
i powoduje przejście do nowej komórki. 

Znak *." kończy przeględanie pamięci. 


np. 
S100 
0100 34  C3  /CR/ 
0101 24 /CR/ 
0102 CF "ASCII /CR/ 
0107 6E s X+5 /CR/ 
0108 D4 . /CR/ 


Dyrektywa wykonania N instrukcji ze śledzeniem 


TN - wykonanie N instrukcji 


— TN - jak wyżej; nie wyświetla symboli podczas 
śledzenia 


TWN  - wykonanie instrukcji bez śledzenia podprogra- 
mów 
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= TWN  - jak wyżej; nie wyświetla symboli podczas 
śledzenia 


gdzie: 


N - liczba instrukcji do wykonania; gdy nie poda- 
na to przyjmowane 1 


Dyrektywa wykonania N instrukcji 


UN - wykonanie N instrukcji bez wypisywania stanu 
procesora 


UWN - jak wyżej bez śledzenia podprogramów 


gdzie: 


N - liczba wykonywanych instrukcji; gdy nie podana 
to 1. 


Dyrektywa jest realizowana analogicznie jak dyrektywa 
T, tylko bez wypisywania stanu procesora podczas 
wykonywania programu. 

Wykonanie programu można w każdej chwili przerwać 
wciskając dowolny klawisz. 


Dyrektywa wyprowadzająca wskaźniki i rejestry proceso- 
ra. 


X  - wyprowadzenie zawartości wszystkich wskaźników 
i rejestrów procesora 


XF - wyprowadzenie wartości podanego wskaźnika F 
i oczekiwanie na zmianę wartości 
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XR - wyprowadzenie zawartości rejestru /lub pary 
rejestrów/ R i oczekiwanie na zmianę zawartości 


F - oznaczenie wskaźników procesora: 


C - przeniesienie 

Z - zero 

M - minus 

E - parzystość 

I - przeniesienie połówkowe 


R - oznaczenie rejestrów lub pary rejestrów: 


- akumulator 

- para BC 

- para DE 

- para HL 

- wskaźnik stosu SP 

- licznik rozkazów PC 


00 I O W >» 


Wskaźniki i rejestry sę wyświetlane w postaci: 
CZMEJ AsHH B=uHHHH DsHHHH S:HHHH P=HHH OPCODE SYM 


CZMEJ - Wartości wskaźników: odpowiednia litera, gdy 
wskaźnik ustawiony - /kreska/ gdy wyzerowany, 


HHHH - Zawartość rejestrów w postaci liczby heksadecy- 
malnej 


OPCODE - Instrukcja w postaci mnemonicznej 


SYM - Argument instrukcji w postaci symbolu 
np. 
X 


C---J As23 BzO0000 Ds23FF Ha5001 SsFFOO Pas1245 LXI H,2001 
TAB XB 


Ba:000 1234 /CR/. 
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Druk: ZE „ELWRO”, MGW--zam.484/87/2 000 


